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PREFACE 


The purpose of this manual is to describe the capabilities of HP 3000 to HP 1000 communications using 
Hewlett-Packard’s DS Network Services product, DS/3000. These capabilities include using remote RTE 
commands to the HP 1000, using remote EXEC calls to the HP 1000, performing Remote File Access to 
files at the HP 1000, and perform Program-to-Program communications between the HP 3000 and 
HP 1000. 


The capabilities that exist for HP 3000 to HP 1000 communications are a subset of the total capabilities 
available for HP 3000 to HP 3000 communications or HP 1000 to HP 1000 communications. That is, as 
an HP 3000 user, you will not be able to perform all of the functions available for HP 3000 to HP 3000 
communications. Likewise, not all functions available for HP 1000 to HP 1000 communications are 
possible for HP 3000 to HP 1000 communications. 


NOTE 


Most of the capabilities for HP 3000 to HP 1000 communications are 
programmatic. The interactive interface provides HP 1000 break mode 
commands only. 


This manual will describe HP 3000 to HP 1000 communications assuming that the user is knowledgeable 
about the basic operating principles of both the HP 3000 and HP 1000 or that an HP 3000 user and 
HP 1000 user are working together. 


The operating principles of the HP 3000 Series II/III/30/33/39/40/42/44/48/64 and 68 are described 
in the following manuals. 


e HP 3000 Computer Systems, MPE Commands Reference Manual (30000-90009) (MPE IV 

release); or 

HP 3000 Computer Systems, MPE V Commands Reference Manual (32033-90006); 

DS/3000 HP 3000 to HP 3000 User/Programmer Reference Manual (32185-90001); 

DS/3000 HP 3000 to HP 3000 Network Administrator Manual (32185-90002); 

Fundamental Data Communications Handbook (5957-4634); 

HP 3000 Computer System, MPE Intrinsics Reference Manual (30000-90010) (MPE IV release); 

or 

HP 3000 Computer Systems, MPE V Intrinsics Reference Manual (32033-90007); 

e HP 3000 Computer System, System Manager/System Supervisor Reference Manual 
(30000-9001 4) (MPE IV release); 

e HP 3000 Computer System, Console Operator's Guide (32002-90004) (MPE IV release); 

e HP 3000 Computer Systems, MPE V System Operation and Resource Management Reference 
Manual (32033-90005). 
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NOTE 


The HP 3000 Computer System, MPE V System Operation and Resource 
Management Reference Manual listed above is the MPE V replacement for 
the System Manager/System Supervisor and Console Operator's Guide 
reference manuals. 


The HP 1000 user should refer to the following manuals for information on using DS/1000-IV: 


DS/1000-IV User's Manual (91750-90002); 

DS/1000-IV Network Manager's Manual, Vol. I and II (91750-90010 and 91750-9001 1); 

Getting Started With DS/1000-IV (91750-90004); a“ 
DS/1000-IV Quick Reference Guide (91750-90005), = 
Data Communications Handbook, Section D (32185-90006), 

RTE-IVB Programmer's Reference Manual (92068-90004); or 

RTE-6/VM Programmer's Reference Manual (92084-90005); or 

RTE-A Programmer's Reference Manual (92077-90007). 


~ 


For information about comunications between an HP 1000 and an HP 3000 
from the HP 1000, see the DS/1000-IV User's Manual. 
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CONVENTIONS USED IN THIS MANUAL 





NOTATION 


nonitalics 


italics 


{ } 


DESCRIPTION 


Words in syntax statements which are not in italics must be entered exactly as 
shown. Punctuation characters other than brackets, braces and ellipses must also be 
entered exactly asshown. For example: 


EXIT; 


Words in syntax statements which are in italics denote a parameter which must be 
replaced by a user-supplied variable. For example: 


CLOSE filename 


An element inside brackets in a syntax statement is optional. Several elements 
stacked inside brackets means the user may select any one or none of these elements. 
For example: 


[3 User may select A or B or neither. 


When several elements are stacked within braces in a syntax statement, the user must 
select one of those elements. For example: 


A 
B User must select A or B or C. 
C 


A horizontal ellipsis in a syntax statement indicates that a previous element may be 
repeated. For example: 


[,itemname]...3 


In addition, vertical and horizontal ellipses may be used in examples to indicate that 
portions of the example have been omitted. 


A shaded delimiter preceding a parameter in a syntax statement indicates that the 
delimiter must be supplied whenever (a) that parameter is included or (b) that 
parameter is omitted and any other parameter which follows is included. For 
example: 


itema[,itemb] [;iteme] 


means that the following are allowed: 


itema 

ttema,itemb 
itema,itemb,iteme 
itema,,iteme 
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underlining 





CONTROL) Char 


When necessary for clarity, the symbol A may be used in a syntax statement to 
indicate a required blank or an exact number of blanks. For example: 


SET[ (modifier) ]A(variable) ; 


When necessary for clarity in an example, user input may be underlined. For 
example: 


NEW NAME? ALPHA 


Brackets, braces or ellipses appearing in syntax or format statements which must be 
entered as shown will be underlined. For example: 


LET var[[subseript]] = value 


Output and input/output parameters are underlined. A notation in the description 
of each parameter distinguishes input/output from output parameters. For example: 


CREATE (parm! ,parm2,flags,error) 


Shading represents inverse video on the terminal’s screen. In addition, it is used to 
emphasize key portions of an example. 


The symbol C___) may be used to indicate a key on the terminal’s keyboard. For 
example, indicates the carriage return key. 


Control characters are indicated by followed by the character. For example, 
(CONTROL)Y means the user presses the control key and the character Y simultaneously. 
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Hewlett-Packard’s AdvanceNet is a combination of hardware and software products that make it possible 
for Hewlett-Packard computer systems to communicate with one another, and with IBM mainframes as 
well. The connections can be made over hardwired lines, and/or over the public telephone facility, 
and/or across Public Data Networks (PDNs), in any mixture. This capability, coupled with our proven 
remote entry capability to IBM computer systems, provides a total solution to large-company electronic 
data processing (EDP) needs. 


Within the realm of AdvanceNet is the software subsystem that accomplishes HP computer-to-HP 
computer communication over these connecting lines. This software subsystem is the DS Network 
Services product, DS/3000. 


This manual] describes how an HP 3000 user can communicate with an HP 1000 computer by establishing 
a communications link using DS/3000. Since each of these computers perform functionally different 
data processing tasks, their association in a network provides you with the benefits of their combined 
capabilities. 


Once the communications link is established, DS/3000 allows you to: 


e Use remote RTE operator commands to the HP 1000 System. The RTE operator commands 
are executed in the remote HP 1000 but the output resulting from the executed commands 
will appear at your log-on terminal at the HP 3000 end. This is described in Section 3. 


e Use remote EXEC calls to the HP 1000 System. Remote EXEC calls allow you to interface 
with remote I/O devices programmatically. This is described in Section 4. 


e Perform Remote File Access to files in the HP 1000 System, using RFA _intrinsics 
programmatically. This capability permits you to access any of the disc files residing at the 
remote HP 1000 as though they reside at your local HP 3000 site. This is described in Section 
5. 


e Perform Program-to-Program Communication between the HP 3000 and HP 1000 system, 
using Program-to-Program (PTOP) intrinsics. This capability permits programs residing in 
different HP computer systems to interactively exchange information with one another in a 
coordinated manner. This is described in Section 6. 


But what exactly does this overall capability mean? It means that a large multidivisional corporation can 
have a truly coordinated world-wide network of computer systems. They are coordinated in the sense of 
tying together the various commercial and industrial functions within each division and factory, and they 
are also coordinated in the larger sense of tying together the various divisions and factories at the 
corporate level. 


For example, imagine a large corporation which has factories in the United States, Canada, France, and 
West Germany. Within each factory there are HP 1000 computer systems performing such functions as 
inventory control, factory data collection, and operations management. With a Hewlett-Packard 
Distributed Systems Network these manufacturing information systems can be tied into an HP 3000 
system which handles the factory’s administrative functions (such as finance and accounting). The 
administrative systems of each factory can, in turn, be connected not only to one another but also to a 
mainframe computer (via RJE, MRJE, or SNA NRJE) at corporate headquarters. This overall networking 
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capability makes it possible to perform financial analysis and control at a group and corporate level as 
well as at the individual factories. 


The following summarizes the four ways you can use DS/3000 to communicate with HP 1000 systems: 


REMOTE 
OPERATOR 
COMMANDS 


REMOTE 
EXEC 
CALLS 


REMOTE 
FILE 
ACCESS 


PROGRAM 
TO 
PROGRAM 
COMMUNI- 
CATION 


HP 3000 


From a terminal, issue a remote 
command. 


Write and execute an _ SPL, 
FORTRAN, PASCAL, or COBOL/II 
program using remote EXEC calls. 


Write and execute an _ SPL, 
FORTRAN, PASCAL, or COBOL/II 
program using Pemote File Access 
(RFA) intrinsics. 


Write and execute a master or slave 
program in SPL, FORTRAN, 
PASCAL, COBOL, COBOL/II, or 
BASIC using Program-to-Program 
intrinsics. 


HP 1000 


Execute an operator command. 


Execute an EXEC call. 


Access a disc file. 


Write and execute a master or slave 
program in FORTRAN, PASCAL, 
or assembly language using 
Program-to-Program intrinsics. 


In Program-to-Program (PTOP) communications, the programs can reside on either system: 
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HP 3000 


or 


HP 1000 


Master Program —————————-> Slave Program 


Slave Program «<——————_—_———- Master Program 
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Asa simplified example of a computer network, imagine that you are in the same room with an HP 3000 
(labeled "System A" in Figure 1-1) and that an HP 1000 (labeled "System B") resides in another part of the 
building. These two computers are connected to one another by a cable and a pair of communications 
interfaces. With DS/3000 you can use the processing capability of both the HP 3000 and the HP 1000 
and pass data back and forth between them by entering commands through a single terminal. 


To see how DS/3000 works in this simple example, read through the step-by-step procedure which 
follows. 


HP3000 Communications HP1000 
SYSTEM A Interface SYSTEM B 
Interconnecting 
Cable 


Figure 1-1. HP 3000 to HP 1000 Example 
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Step 1. Sit down at a terminal connected to System A and initiate a session. 


RETURN 
>HELLO USER. ACCOUNT 


HP3000 / MPE V G.02.00. WED, OCT 22, 1985, 9:12 AM 


WELCOME TO SYSTEM A. 


Within the context of DS/3000, such a session is referred to as a local session because it is active within 
the HP 3000 to which your terminal is directly connected. This terminology becomes more meaningful 
later, since all you have actually done, so far, is initiate a standard MPE session. At this point, you have 
reached the situation illustrated in Figure 1-2. 


HP3000 Communications HP1000 
SYSTEM A Interface SYSTEM B 





Interconnecting 
Cable 





Figure 1-2. Initiating the Local Session 
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Step 2. Now, open a communications line between System A and System B. Do this by entering a 
:DSLINE command. 





:DSLINE RSYS1000 


DS LINE NUMBER = #L3 


In this example, RSYS1000 is the device class name for the particular line established during system 
configuration (in System A) you wish to use. DS/3000 opens the line and then assigns you a line number 
(3 in this example). This line number is analogous to the file number returned to you by the MPE File 
System when you open a file programmatically using the FOPEN intrinsic. Within your local session, it 
uniquely identifies the particular line that you have opened. This becomes significant only if you must 
open more than one communications line during a session. 





Step 3. Now that you have acquired access to a communications line between System A and System B, 
you may execute remote RTE operator commands. Do this by entering a REMOTE command which 
if includes an RTE operator command for the remote system. For example, use the RTE-6/VM command 
. TI to determine the remote HP 1000 system time. 


:REMOTE TI 


1985 330 8 39 3 





Step 4. Now determine the time from the local HP 3000 using the MPE SHOWTIME command. 
: SHOWTIME 
MON, NOV 4, 1985, 8:27AM 


Notice that in Steps 3 and 4 it is the presence or absence of the REMOTE prefix which determines whether 
a command is to be executed on the local system or on the remote system. 
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Step 5. Suppose you wish to use the line printer on the HP 1000. This time, instead of having to use the 
REMOTE prefix for each command, try a different technique. Enter the following: 





>: REMOTE 
# 


This command gives you access to the remote system in such a way that all commands which follow can 


be entered in their normal form (without the prefix REMOTE). The # is the prompt character issued by 
DS/3000 (in place of the usual MPE colon prompt). 


Step 6. Now determine the status of the remote line printer. If the line printer is down, enable it. 
#£Q,6 — 
36 DV.12 0 BUO 1 | 
#UP,6 
#EQ,6 


36 DV.12 0 BUOO 


” 


Step 7. The work in System B is now completed so return control to your local session by typing a colon. 





#: 


Note that you are now back in the local session in System A (signified by the colon prompt). To close the 
communications line, enter the following variation of the :DSLINE command: 


:DSLINE RSYS1000;CLOSE 


1 DS LINE WAS CLOSED. 
Finally, terminate the local session. 


: BYE 


CPU=1. CONNECT=11. MON, NOV 4, 1985, 10:16 AM “ 
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As an HP 3000 user you need only issue a :DSLINE user command from your terminal to establish a link 
with an HP 1000 system. 


However, before you can issue this command successfully, the hardware connections must be made, and 
the DS/3000 and DS/1000-IV software enabled. To do this: 


e The HP customer engineer installs the hardware connection between the systems. 


e The HP 1000 network manager generates a DS/1000-IV network and runs the program DINIT 
(and DSLIN if necessary). Instructions are provided in the Network Manager's manuals. 


e The HP 3000 system supervisor configures the HP 3000 system to include DS/3000. Instructions 
are provided in the System Manager/System Supervisor Manual. 





e The HP 3000 system operator initiates the :DSCONTROL command to enable the DS subsystem on 
the communications link. Instructions are provided in Appendix B of this manual. 


Now you can log on to a terminal and issue the :DSLINE user command to establish communications with 
the HP 1000 system. (See Figure 2-1.) 


NOTE 


The term session is used: rather loosely in this section to differentiate 

between work done on the local system and work done on the remote 

system (as in local session and remote session). It is not always possible to 

establish a remote session with the HP 1000 in the literal sense. A literal 

definition of session appears later in this section during a brief discussion of 
~~ Session Access versus Non-session Access. 
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The Communications Link 


HP3S000 HP 1000 


— —\_SESSION 


Communications Line 





User’s 
Log-on 
Terminal 


Figure 2-1. DS/3000 Communications Link (HP 3000 to HP 1000) 


OPENING A LINE 


A communications link can be established over a hardwired communications line, over the public 
telephone network, or over an X.25 Public Data Network (PDN). The procedures for opening hardwired 
lines and for opening telephone lines differ only slightly. Much of the discussion which follows for 
Opening a Hardwired Line and Opening a Telephone Line is identical. The information is repeated for 
each topic so that you need only read that which is appropriate for your situation. Generally, once the 
connection to the remote computer is established, you will perceive no difference in the way DS/3000 
performs. 


Opening a Hardwired Line 


What is a hardwired line? In the general field of data communications there are two types of lines 
commonly referred to as hardwired. The first type is a dedicated path on the public telephone network 
that.is leased from the telephone company for the private use of a computer-to-computer configuration. 
Such a line serves as a permanent connection between the two computers. The other type of hardwired 
line is a cable that is connected directly to the communications I/O interfaces of the two computers. 
Within the context of DS/3000, hardwired always refers to the latter. However, the technique used for 
opening a line is the same for either a direct-connect line or a leased (nonswitched) telephone line. 


The hardwired interconnecting cable connects to each computer by way of a communications interface. 
For a hardwire connection, there are two options available: the Hardwired Serial Interface (HSI), or the 
Intelligent Network Processor (INP) to Programmable Serial Interface (PSI). 


The Hardwired Serial Interface (HSI) connection consists of the HP 30360A HSI interface card for the 
HP 3000 Series II and III (Series 30/ 33/40/44 and 64 do not support the HSI), and the HP 12889A HSI 
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card for the HP 1000. Each HSI card occupies one card slot in the Multiplexor channel of the HP 3000 

~ and can accomodate up to four connections to HP 1000s. Only one of the four lines can be used at any 
given time and the HP 3000 console operator has control over which line is active. The HP 3000 Series II 
and III can accomodate a maximum of 2 HSI cards. 


The Intelligent Network Processor (INP) to Programmable Serial Interface (PSI) connection utilizes 
microprocessor-based interface cards in both the HP 3000 and HP 1000, and offloads the task of DS 
transmission management from the CPU to the card. The connection is established by using the 
HP 30010A INP in the HP 3000 Series II and III, or the HP 30020B INP in the HP 3000 Series 

' 30/33/39/40/42/44/48/64 and 68, or the HP 30244M INP in the HP 3000 Series 37 Computer System. 
On the HP 1000 side, an HP 12834A PSI card is used in the HP1000 M, E, and F Series and an 
HP 12082A PSI card is used in the HP 1000 A Series. The maximum distance allowed when using this 
connection is one kilometer. 


The hardwire connections are summarized in Table 2-1. 


Table 2-1. Associations between Controllers and Systems (hardwired line) 


HP 3000 Series II and II HP 30360A HSI card 
HP 30010A INP card 
HP 3000 Series 30/33/39/40/42/44/48/64/68 HP 30020B INP card 
HP 3000 Series 37 HP 30244M INP card 
HP 1000 M, E, and F Series HP 12889A HSI card 
HP 12834A PSI card 
HP 1000 A Series HP 12889A HSI card 
HP 12082A PSI card 
For most applications, the INP to PSI connection offers a much better method of HP 3000 to HP 1000 
communication. The HSI cards impose substantial overhead on the CPU’s (both 3000 and 1000) due to 
eo the combination of a fast transfer rate (2.5 megabits/sec) and a small interface buffer size (1 word). The 
INP to PSI connection operates at up to 56 kilobits/sec, but offers 1024 words of buffering on the INP 


and 1072 words of buffering on the PSI. The microprocessors on each card handle the communications 
protocol and handshaking, thus freeing the CPU for more important tasks. 












It is relatively straightforward to obtain access to a hardwired communications line. All you are required 
to do is identify the particular communications interface you wish to use. You do this by specifying the 
device class name or logical device number associated during system configuration with the desired 
interface. In the example in Section 1, the :DSLINE command was used for this purpose, as follows: 


:DSLINE RSYS1000 


In the :DSLINE command you may also wish to specify the size of the DS/3000 line buffer to be used in 
conjunction with the line. The size of this buffer determines the maximum amount of data that can be 

sent or received in a single physical transmission over the line. Note that a transmission as you normally 

think of it (sending or receiving all or part of a file) may actually consist of many physical transmissions. 

; In essence, this buffer size defines a blocking factor for the line. (See Figure 2-2.) A default buffer size 
‘a is established during system configuration, and in most cases (as in the example in Section 1), you will find 
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it satisfactory to let this default value prevail. 


telephone lines. 
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Figure 2-2, DS/3000 Line Buffer Example 


Linebuffering is the same for both hardwired and 


1200 words of data to be 
transmitted 


First physical transmission: 
$12 words (492 words of data 
+ 20 words of DS overhead) 


Second physical transmission: 
$12 words (492 words of data 
+ 20 words of DS overhead) 


Third physical transmission: 
236 words (216 words of data 
+ 20 words of DS overhead) 


1200 words of data received 
at remote computer 
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When you execute a :DSLINE command, DS/3000 attempts to give you access to the specified 
communications line and, if successful, informs you of the assigned DS line number by displaying the 
following message at your terminal: 


DS LINE NUMBER = #Lx 


where x is the assigned DS line number. In the example in Section 1, the DS line number 3 was assigned. 
The DS line number is significant only if you open and use more than one communications line 
concurrently within a single local session (see "Opening Multiple Lines" later in this section). 


Now that you have established the physical communications line via the :DSLINE command, you will be 
able to communicate with the remote HP 1000. With RTE-6/VM running on the HP 1000M, E, and F 
Series, two possibilities exist depending on how the HP 1000 was GEN’d. The two possibilities are session 
access and non-session access. If the HP 1000 is an A Series running RTE-A, only non-session access is 
available. 


SESSION ACCESS. Session access allows you to log on to the remote HP 1000 using either the REMOTE 
HELLO RUSER.RGROUP format or by issuing the REMOTE command and typing HELLO RUSER.RGROUP in 
response to the remote prompt (#). Session access allows you to access those files available for the 
RUSER.RGROUP session you have established. It is also possible to allow the DS/1000-IV software to 
establish a remote session for you by simply typing REMOTE and the RTE operator command. In this case, 
you will be logged on to a default session on the remote HP 1000. This allows you access to only those 
files assigned to the default session. See the DS/1000-IV User's Manual for details. 


NON-SESSION ACCESS. If the HP 1000 M, E, or F Series was GEN’d for non-session access or if the 
HP 1000 computer is an A Series, it is not possible to establish a session with a set of files belonging to a 
particular group, that is, a REMOTE HELLO is not possible. Once you have established the DS line, you 
have access to all the system files by simply typing the REMOTE command followed by the HP 1000 
command. RTE-A running on the HP 1000 A Series supports only non-session access. 


Opening a Telephone Line 


A DS/3000 communications link can also be established over the public (dial-up) telephone network. In 
such a case, the information passed back and forth between the two computers travels over the same lines 
that are used for normal voice traffic. Each computer is interfaced to the telephone lines by way of a 
modem. (The term modem is a contraction of MOdulator-DEModulator.) A modem is a device that 
translates digital signals (electrical impulses) generated by a computer into analog signals (tones) that can 
be transmitted over telephone lines, and vice versa. 


The modem connects to the HP 3000 or the HP 1000 through the use of a communications interface. For 
the HP 3000 Series II and III, an HP 30055A SSLC card or an HP 30010A INP interface may be used. 
For the HP 3000 Series 30, 33, 39, 40, 42, 44, 48, 64, or 68, an HP 30020B INP interface is used, while 
for the HP 3000 Series 37, an HP 30244M INP interface is required. The HP 12793A BISYNC MODEM 
PSI card is used in the HP 1000 M, E, and F Series and the HP 12073A BYSYNC MODEM PSI card is used 
in the HP 1000A Series. Refer to Table 2-2 for a summary of the hardware requirements for an 
HP 3000 to HP 1000 modem connection. 
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Table 2-2. Associations between Systems and Controllers (telephone line) 


System Controller 


HP 3000 Series II and III HP 30055A SSLC I/0 card 
HP 30010A INP card 


HP 3000 Series 30/33/39/40/42/44/48/64/68 HP 30020B INP card 
HP 3000 Series 37 HP 30244M INP card 
HP 1000 M, E, and F Series HP 12793A BISYNC MODEM PSI card 
HP 1000 A Series HP 12073A BISYNC MODEM PSI card 





It is a little more complex to obtain access to a telephone line than to a hardwired line. First, you must 
identify the particular communications interface (INP or SSLC) you wish to use. You do this by 
specifying the device class name or logical device number of the communication line that was associated 
during system configuration with the desired interface. You can use the :DSLINE command for this 
purpose, as follows: 


:DSLINE RSYS1000 


In the :DSLINE command, you may also wish to specify the size of the DS/3000 line buffer to be used in 
conjunction with the line. The size of this buffer determines the maximum sized block that can be sent 
or received in a single physical transmission over the line. Note that a transmission as you normally think 
of it (sending or receiving all or part of a file) may actually consist of many physical transmissions. In 
essence, this buffer size defines a blocking factor for the line. (See Figure 2-2.) A default buffer size 1s 
established during system configuration, and in most cases (as in the example in Section 1), you will find it 
satisfactory to let this default value prevail. Linebuffering is the same for both hardwired and telephone 
lines. 


Next, you may wish to supply a set of identification (ID) sequences to be used in verifying that the desired 
pair of computers are connected to one another. This is discussed under "ID Sequences" later in this 
section. Briefly, however, you may supply an ID sequence that identifies your HP 3000 and one or more 
ID sequences that identify those remote computers with which your HP 3000 may validly be connected. 
When a telephone connection is established between your HP 3000 and a remote HP 1000, the two 
computers exchange ID sequences and their validity determines whether or not the connection is to 
remain in effect. You use the :DSLINE command to supply ID sequences, as follows: 


:DSLINE RSYS1000 ;LOCID="SYSTEM A" & 
;REMID="SYSTEM X" 


where SYSTEM A is the ID sequence identifying your HP 3000 and SYSTEM X is the ID sequence 
identifying the remote computer with which you want to establish a telephone connection. 


Again, there are default values that can be established during system configuration. In most cases, 
however, you will at least want to explicitly identify the desired remote HP 1000 to be certain that the 
proper connection is being established. 


Now you must establish the physical connection between the two computers by dialing (at the modem) the 


telephone number of the remote computer and responding (at the system console) to the dial request. If 
you wish to have the console operator of your HP 3000 dial the number for you, you may supply the 
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desired number in the :DSLINE command and it will be displayed as part of a dial request message at the 
operator’s console. In this case, you would supply the telephone number as follows: 


:DSLINE RSYS1000 ;LOCID="SYSTEM A" & 
;REMID="SYSTEM X" & 
; PHNUM=555- 1234 


If autodial equipment is installed on the RSYS1000 line, the telephone number supplied in the :DSLINE 
command is used instead of the number configured for the line. If a phone number is not supplied in the 
: DSLINE command, the configured number will be dialed. 


The various possibilities involved in establishing a telephone connection with a remote computer are 
discussed under "Dialing the Remote Computer" later in this section. 


When you execute the :DSLINE command, DS/3000 attempts to give you access to the specified 
communications interface (INP or SSLC) and, if the telephone connection is successfully established, 
informs you of the assigned DS line number by displaying the following message at your terminal: 


DS LINE NUMBER = #Lx 


where x is the assigned DS line number. In the example in Section 1, the DS line number 3 was assigned. 
The DS line number is significant only if you open and use more than one communications line 
concurrently within a single local session (see "Opening Multiple Lines" later in this section). 


Now that you have established the physical communications line via the :DSLINE command, you will be 
able to communicate with the remote HP 1000. With RTE-6/VM running on the HP 1000 M, E, and F 
Series, two possibilities exist depending on how the HP 1000 was GEN’d. The two possibilities are session 
access and non-session access. If the HP 1000 is an A Series running RTE--A, only non-session access is 
available. 


SESSION ACCESS. Session access allows you to log on to the remote HP 1000 using either the REMOTE 
HELLO RUSER.RGROUP format or by issuing the REMOTE command and typing HELLO RUSER.RGROUP in 
response to the remote prompt (#). Session access allows you to access those files available for the 
RUSER.RGROUP session you have established. It is also possible to allow the DS/1000-IV software to 
establish a remote session for you by simply typing REMOTE and the RTE operator command. In this case, 
you will be logged on to a default session on the remote HP 1000. This allows you access to only those 
files assigned to the default session. See the DS/1000-IV User's Manual for details. 


NON-SESSION ACCESS. If the HP 1000 computer M, E, or F Series was GEN’d for non-session access 
or if the HP 1000 is an A Series, it is not possible to establish a session with a set of files belonging to a 
particular group, that is, a REMOTE HELLO is not possible. Once you have established the DS line, you 
have access to all the system files by simply typing the REMOTE command followed by the HP 1000 
command. RTE-A running on the HP 1000 A Series supports only non-session access. 


Specifying a Line 


As you have seen, in order to open either a hardwired communications line or a dial-up telephone line, 
you must specify a device class name or logical device number identifying the particular communication 
line that is associated with a specific INP, HSI, or SSLC that you wish to use. But how do you figure out 
which name or number to specify? The discussion of this topic may seem a little complex and tedious, 
particularly at first reading. In actual practice, however, once the hardware and software configuration is 
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installed and usable, most DS/3000 sites will post a notice defining all of the available communications 
lines and the proper device class names and logical device numbers for each. In that case, all of the 
detective work described in the following paragraphs is already done for you. 


For each communications interface, there is a pair of associated drivers. First, there is the actual INP, 
HSI, or SSLC driver that directly controls the operation of the interface board. In addition, there is a 
DS/3000 communications driver that controls the operation of the INP, HSI, or SSLC driver. The names 
of these drivers are as follows: 


IOINPO (INP driver) 

CSH BSco (HSI driver) 

CSSBSCO = (SSLC driver) 

IODSO (DS/3000 communications driver, while utilizing the bisync protocol) 
IODSX (DS/3000 communications driver, while utilizing the X.25 capability) 


If you have only one communications interface (INP, HSI, or SSLC) configured into your system, there is 
no question about which name or number to specify ina :DSLINE command. If there is more than one 
communications interface, however, you must know (or ask someone who knows) which CSHBSCO, 
CSSBSCO, or IOINPO pertains to the physical line you want to use. 


One or more virtual terminal drivers (IODSTRMO or IODSTRMX) should also be configured into the 
system. The IODSTRMO or IODSTRMX entries allow users on another system to be logged on to this 
system and regulate the number of remote Session Main Processes (SMP) that can be assigned to a given 
line. Each IODSTRMO or IODSTRMxX entry is related to the proper communications interface entry by 
the number specified in the column labeled DRT. Figure 2-3 shows logical devices 60 through 64 are 
paired with logical device 12; Figure 2-4 shows logical device 69 paired with logical device 27; Figure 
2-5 shows logical device 71 paired with logical device 29; and Figure 2-6 shows logical device 68 paired 
with logical device 26. 


Now look at the appropriate sample I/O device table produced during system configuration (See Figure 
2-3 and 2-4 for a hardwired line or Figure 2-5 and 2-6 for a telephone line). 


In Figure 2-3, notice that the HSI board entries (logical devices 12 through 15) look the same except for 
the PORTMASK. The PORTMASK specifies which port on the board is to be used. There are also virtual 
terminals (logical devices 60 through 64) referencing back to logical device 12. Since only one port on the 
HSI board can be opened at a time, only one block of virtual terminal entries is needed for that board. As 
each port is opened individually by specifying the corresponding dsdevice in the :DSCONTROL command 
(see Appendix B), the system automatically reallocates the block of virtual terminal entries to the proper 
HSI board entry. This reallocation will not, however, show up in the I/O configuration table. 


In Figure 2-3, the shaded items in the column labeled DRIVER NAME show four HSI lines (CSHBSCO) 
configured into the system as logical devices 12 through 15. For each one of these lines, there is a 
DS/3000 communications driver, IODSO, also configured into the system. Each IODSO entry is related to 
the proper HSI entry by the number specified in the column labeled DRT (the # prefix indicates a back 
reference to a previously defined logical device number). Logical devices 50 through 53 are paired with 
logical devices 12 through 15, respectively. In this example, it is the device class name or logical device 
number of the appropriate IODSO entry that would be used to specify the desired line. 
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DEV # 
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Cc T SUB REC OUTPUT 
H Y TYPE TERMINAL WIDTH DEV 
A P TYPE SPEED 

NE 

00 6 128 0 
00 3 128 0 
08 O 40 LP 

0 32 2 66 0 
0 240 128 LP 

0 240 128 LP 

0 24 0 128 LP 

0 24 0 128 LP 

0 34 0 128 0 
019 3 0 0 
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0 19 3 0 0 
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0 41 1 128 0 
0 16 8 Se 8S 40 68 
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0 41 0 ‘ei 128 0 
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DRIVER 
NAME 


IOMDISC1 


IOMDISCO 
TOCRDO 

IOPRTO 

IOTAPEO 
IOTAPEO 
IOTAPEO 
IOTAPEO 
IOPTPNO 
CSHBSCO 





IOTERMO 
IOTERMO 
IOTERMO 
IOTERMO 
IOTERMO 
IOINPO 

IOINPO 

CSSBSCO 





IODSTRMO 
TODSTRMO 
ITODSO 

IODSTRMO 


Figure 2-3. Sample I/O Device Table (Hardwired Line with HSI) 


DEVICE 
CLASSES 


SPOOL 
SYSDISK 
DISC 
CARD 

LP 
TAPE 
TAPE 
TAPE 
BATAPE 
PTPUNCH 
HST1 
HST2 
HSI3 
HST4 
CONSOLE 
TERM 
TERM 
TERM 
TERM 
TERM 
INP1 
INP2 
SSLC2 
HDS 1 
HDS2 
HDS3 
HDS4 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSLINE1 
DSLINE2 
INP1 
INP2 
SDS 1 
DSTERM 
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In Figure 2-4, the shaded items in the column labeled DRIVER NAME show an INP (IOINPO) configured 
into the system as logical device 27. (Note that the subtype is 3, indicating hardwired.) For this line, 
there is a DS/3000 communications driver (IODSO) also configured into the system. The IODSO entry is 
related to the proper INP entry by the number specified in the column labeled DRT (the # prefix indicates 
a back reference to a previously defined logical device number). Logical device 67 is paired with logical 
device 27. In this example, it is the device class name (DSLINE2) or logical device number (67) of the 
IODSO entry that would be used to specify the desired line. 


NOTE 


Figure 2-4 does not show a line configured for X.25 activity to an 
HP 1000. The back referencing scheme is identical to this example. 
However, the following differences should be noted for an X.25 
configuration: 


e The communications driver is named IODSX. 


e The device class name or logical device number of an IODSX entry should 
not be used in a :DSLINE command (or in other commands, such as 
DSCOPY). To access the desired remote node, we encourage X.25 Link 
users to enter a nodename whenever a dsdevice is required. See 
"Specifying an X.25 Line" later in this section. 
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LOG DRT U CT SUB REC OUTPUT MODE DRIVER DEVICE 
DEV # N HY TYPE TERMINAL WIDTH DEV NAME CLASSES 
# I AP TYPE SPEED 
TNE 
1 4 0 00 6 128 OO IOMDISC1 SPOOL 
SYSDISK 
0 00 3 128 OO IOMDISCO DISC 
0 08 0 40 LP JA $S IOCRDO CARD 
0 0322 66 0 S IOPRTO LP 
0 0240 128 LP IOTAPEO TAPE 
1 0 240 128 LP IOTAPEO TAPE 
2 0240 128 LP IOTAPEO TAPE 
3 0 240 128 LP JA S IOTAPEO  BATAPE 
0 0340 128 0 IOPTPNO — PTPUNCH 
0 0193 0 0 CSHBSCO —-HSI1 
0 0193 0 0 CSHBSCO —-HSI2 
0 0193 0 0 CSHBSCO -HSI3 
0 0193 0 ) CSHBSCO —-HSI4 
0 0160 10 2 40 20 JAID IOTERMO CONSOLE 
10160 11 2? 40 21 JAID IOTERMO TERM 
20160 11 2? 40 22 JAID IOTERMO TERM 
3 0160 11 2? 40 23 JAID IOTERMO TERM 
4 0160 11 2? 40 24 JAID IOTERMO TERM 
5 0161 11 2 40 25 JAID IOTERMO TERM 
0 0170 0 0 IOINPO —INP1 
0 0178 0 0 | INP2 
0 0180 0 0 SSLC2 
0 0410 128 0 HDS 1 
0 0410 128 0 HDS2 
0 0410 128 0 HDS3 
0 0410 128 0 IODSO HDS4 
0 0168 ?? 2 40 60 J ID IODSTRMO DSTERM 
0 0168 ?? 2? 40 61 J ID IODSTRMO DSTERM 
0 0168 7? 2 40 62 J ID IODSTRMO DSTERM 
0 0168 2? 2 40 63 J ID IODSTRMO DSTERM 
0 0168 ?? 2 40 64 J ID IODSTRMO DSTERM 
0 0168 ?? 2 40 65 J ID IODSTRMO DSTERM 
00411 128 OO DSLINE1 
00411 128 OO DSLINE2 
0 0168 ?? 2? 40 68 J ID INP1 
00168 ?? 2? 40 69 JID #6 INP2 
0 0410 22 128 0 IODSO SDS1 
0 0168 ?? 2? 36 71 J ID IODSTRMO DSTERM 





Figure 2-4, Sample I/O Device Table (Hardwired Line with INP) 
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In Figure 2-5, the shaded items in the column labeled DRIVER NAME show one SSLC (CSSBSCO) 
configured into the system as logical device 29. (Note that the subtype is 0, indicating a switched 
telephone line.) Notice the DS/3000 communications driver, IODSO, is related to the SSLC entry by the 
number specified in the column labeled DRT (the # prefix indicates a back reference to a previously 
defined logical device number). Logical device 70 is paired with logical device 29. It is the device class 
name (SDS1) or logical device number (70) of the IODSO entry that would be used to specify the desired 
line. 
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CT SUB REC 
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AP TYPE SPEED 

NE 
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00 3 128 
08 0 40 
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0 19 3 ) 
0193 0 

0 19 3 ) 

0 19 3 0 
0160 10 ?? 40 
0160 11 ?? 40 
0160 11 ?? 40 
0160 11 2? 40 
0160 11 2? 40 
0161 11 2? 40 
0170 0 
0173 0 

0 18 @ 0 

0 410 128 
0 41 0 128 
0 41 0 128 
0 410 128 
0168 ?2 ?2 40 
0168 ?? 2? 40 
0168 ?? ?2 40 
0168 ?? 2? 40 
0168 ?? 22 40 
0168 ?? 22 40 
041 1 128 
0 41 1 128 
0168 ?? ?? 40 
0168 ?? 2? 40 
0 410 22 128 
0168 ?2 2? 36 
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DRIVER 
NAME 


ITOMDISC1 


IOMDISCO 
TOCRDO 
ITOPRTO 
IOTAPEO 
IOTAPEO 
IOTAPEO 
ITOTAPEO 
IOPTPNO 
CSHBSCO 
CSHBSCO 
CSHBSCO 
CSHBSCO 
TOTERMO 
IOTERMO 
IOTERMO 
IOTERMO 
TOTERMO 
IOTERMO 
ITOINPO 





IODSO 
IODSTRMO 
IODSTRMO 
IODSTRMO 
IODSTRMO 
ITODSTRMO 
IODSTRMO 
IODSO 
IODSO 
IODSTRMO 
IODSTRMO 
ToDso 
ag iyi 





Figure 2-5. Sample I/O Device Table (Telephone Line with SSLC) 


DEVICE 
CLASSES 


SPOOL 
SYSDISK 
DISC 
CARD 

LP 
TAPE 
TAPE 
TAPE 
BATAPE 
PTPUNCH 
HST1 
HST2 
HSI3 
HST4 
CONSOLE 
TERM 
TERM 
TERM 
TERM 
TERM 
INP1 
INP2 
SSLC2 
HDS 1 
HDS2 
HDS3 
HDS4 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSLINE1 
DSLINE2 
INP1 
INP2 
SDS1 
DSTERM 
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In Figure 2-6, the shaded items in the column labeled DRIVER NAME show an INP (IOINPO) configured 
into the system as logical device 26. (Note that the subtype is 0. This indicates that the INP is used for a 
dial-up line.) For this line, there is a DS/3000 communications driver, IODSO, also configured into the 
system. The IODSO entry is related to the proper INP entry by the number specified in the column 
labeled DRT (the # prefix indicates a back reference to a previously defined logical device number). 
Logical device 66 is paired with logical device 26. It is the device class name (DSLINE1) or logical device 
number (66) of the IODSO entry that would be used to specify the desired line. 

















The Communications Link 









‘- LOG DRT U CT SUB REC OUTPUT MODE DRIVER DEVICE 
DEV # N HY TYPE TERMINAL WIDTH DEV NAME CLASSES 
# I AP TYPE SPEED 
TNE 
1 4 0006 128 0 IOMDISC1 SPOOL 
SYSDISK 
000 3 128 OO IOMDISCO DISC 
008 0 40 LP JA § IOCRDO CARD 
0 0322 66 0 S IOPRTO LP 
0 0240 128 LP IOTAPEO TAPE 
1 0240 128 LP IOTAPEO TAPE 
2 0240 128 LP IOTAPEO TAPE 
3 0240 128 LP JA $ IOTAPEO  BATAPE 
0 0340 128 «OO IOPTPNO PTPUNCH 
0 0193 0 0 CSHBSCO —-HSI1 
~ 0 0193 0 0 CSHBSCO —-HSI2 
| 0 0193 0 0 CSHBSCO HSI3 
0 0193 0 0 CSHBSCO HSI4 
00160 10 ?? 40 20 JAID IOTERMO CONSOLE 
10160 11 2? 40 21 JAID IOTERMO TERM 
20160 11 2? 40 22 JAID IOTERMO TERM 
3 0160 11 2? 40 23 JAID IOTERMO TERM 
40160 11 2 40 24 JAID IOTERMO TERM 
5 0161 11 2? 40 25 JAID IOTERMO TERM 
0 017% 0 0 t INP1 
00173 0 INP2 
0 0180 0 0 CSSBSCO SSLC2 
0 0410 128 OO IODSO HDS 1 
0 0410 128 «OO IODSO HDS2 
0 0410 128 OO 10DSO HDS3 
0 0410 128 «OO 1ODSO HDS4 
00168 ?2 2? 40 60 J ID IODSTRMO DSTERM 
00168 22 2 40 61 J ID  IODSTRMO DSTERM 
00168 ?? 2 40 62 J 1D IODSTRMO DSTERM 
~~ 00168 22 2? 40 63 J ID IODSTRMO DSTERM 
00168 22 2 40 64 J ID IODSTRMO DSTERM 
00168 ?? 22 40 65 J ID IODSTRMO DSTERM 
0 0411 128 0 1ODSO DSLINE1 
00411 128 0 0 DSLINE2 
00168 ?? 2 40 68 J 1D TODSTRMO INP1 
00168 2? 2 40 69 J ID  IODSTRMO INP2 
0 0410 22 128 OO 1ODSO SDS1 
00168 ?? 2? 36 71 J ID  IODSTRMO DSTERM 





Figure 2-6. Sample I/O Device Table (Telephone Line with INP) 
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Specifying an X.25 Line 

When specifying an X.25 line, you do not use the I/O device table. This is because X.25 uses node names, 
rather than LDEVs, to specify devices. To find out what node names are configured on your system, type 
the following: 

:RUN NETCONF. PUB.SYS 

>LIST 


For more information on NETCONF, see the DS/3000 HP 3000 to HP 3000 Network Administrator 
Maaual. 











:DSLINE 


The format of the :DSLINE command, as used to open an HP 3000 to HP 1000 line, is presented here. In 
addition to opening a hardwired line or a telephone line, this command can also be used for closing one or 
more communications lines (discussed later in this section). 





Syntax 


:DSLINE dsdevice [;LINEBUF=buffer-size] 

s; EXCLUSIVE] 

;QUIET] 

; PHNUM=tel ephone-number ] 

; LOCID=lLocal-id-sequence] 

; REMID=remote-id-sequence|[,...remote-id-sequence] ] 
3; OPEN ] 


[ 
[ 
[ 
[ 
[ 
[ 
[ 





NOTE 


The complete syntax of the :DSLINE command includes parameters to 
indicate compression or no compression (COMP or NOCOMP). These 
parameters are not available on the HP 3000 to HP 1000 link. 





Parameters 


dsdevice (Required). This is the device class name or logical device number assigned 
to the DS/3000 communications driver (IODSO) during system 
configuration, or a logical node name for X.25. This parameter specifies 
what physical hardwired line or what communications interface (and 
modem) you wish to use. 





NOTE 


X.25 Link users should always use a node 
name rather than a line identifier. The 
logical node name appears in the 
configuration file for a Public Data Network 
(PDN). A Remote Node (RN) table relates 
the logical node name (specified in this 
command) to the logical device number of 
the appropriate IODSX driver (the X.25 
driver), and to the PDN address of the 
destination node. 


:DSLINE 


buffer-size 


EXCLUSIVE 


QUIET 


(Optional). A decimal integer specifying the size (in words) of the DS/3000 
line buffer to be used in conjunction with the communications line. The 
integer must be within the range 304 < buffer-size < 4095 when used 
with the SSLC or HSI, and between 304 < buffer-size < 1024 when 
used with the INP. The default value is the buffer size entered in response 
to the PREFERRED BUFFER SIZE prompt during system configuration. 
This parameter overrides the MPE configured value when specified by the 
first user to open the given line. 


(Optional). This parameter, if present, specifies that you want exclusive use 
of the communications line. If the requested line or specified 
communications interface is already open and you have specified the 
EXCLUSIVE option, DS/3000 will deny you access to the line (you cannot 
open it). (See "Line Opening Failures" later in this section.) Opening an 
EXCLUSIVE line requires the user to have CS and ND capability. 


(Optional). When you issue the :DSLINE command with this parameter 
added, the message identifying the DS line number is suppressed. 


The additional parameters that pertain only to opening a telephone line are as follows: 


telephone-number 


lLocal-id-sequence 


(Optional). A telephone number consisting of digits and dashes. The 
maximum length permitted (including both digits and dashes) is 20 
characters. Provided that YES was entered in response to the 
DIAL FACILITY prompt during system configuration, this telephone 
number will be displayed at the operator’s console of your HP 3000 and the 
operator will then establish the telephone connection by dialing that 
number at the modem. (When the autodial feature is present in your 
system, the number provided here is dialed automatically.) The default 
telephone number is the one entered in response to the PHONE NUMBER 
prompt during system configuration. 


(Optional). A string of ASCII characters contained within quotation marks. 
If you wish to use a quotation mark within an ASCII string, use two 
successive quotation marks. The maximum number of ASCII characters 
allowed in the string is 16. 


The supplied string of ASCII characters defines the ID sequence that will be 
sent from your HP 3000 to the remote HP 1000 when you attempt to 
establish the telephone connection. If the remote HP 1000 does not 
recognize the supplied ID sequence as a valid one, the telephone connection 
is terminated. The default value is the ASCII string entered in response to 
the LOCAL ID SEQUENCE prompt during system configuration. 











:DSLINE 


remote-id-sequence (Optional). Same format as Local-id-sequence. 


a The supplied strings of ASCII characters define those remote HP 1000 ID 
sequences that will be considered valid when you attempt to establish the 
telephone connection. If the remote HP 1000 does not send a valid ID 
sequence, the telephone connection is terminated. The default set of 
remote ID sequences consists of the ASCII string entered in response to the 
REMOTE ID SEQUENCE prompt during system configuration. 


OPEN Opens a DS line. 
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Dialing the Remote Computer 


When you are opening a telephone line, you may supply a telephone number as an optional parameter in 
the :DSLINE command to be dialed at the modem connected to the specified INP or SSLC. If you supply 
a telephone number, DS/3000 displays a message on the system console telling the operator to dial that 
number. The operator, after dialing the specified number, enters YES or NO through the system console 
=REPLY command to let DS/3000 know whether or not the telephone connection was successfully made. 
If the operator enters YES, DS/3000 proceeds with the exchanging of ID sequences. If the operator enters 
NO, your :DSLINE request is denied (you cannot open the line). In either case, your terminal’s keyboard is 
disabled until the console operator responds. 


If you do not supply a telephone number, the sequence of events is as described in the above paragraph, 
except that DS/3000 uses (by default) the first telephone number in the PHONELIST established during 
system configuration. 


If you do not supply a telephone number and no PHONELIST was established during system configuration, 
an I/O request message is displayed at the system console, but it does not include the number to be dialed. 
This method might be used when you will dial the remote HP 1000 yourself. Remember, however, that 
the console operator must still know whether you dialed successfully, since he must respond to the console 
message before you are granted access to the line. Because your terminal’s keyboard is disabled until the 
console operator responds with YES or NO, it is recommended that you always supply a telephone number 
in the :DSLINE command. 


ID Sequences 


Once a telephone connection to a remote HP 1000 exists, the two computers exchange ID sequences with 
one another. Within the context of DS/3000, an ID sequence is a string of up to 16 ASCII characters that 
identifies a particular computer. 


During system configuration, each computer can be assigned a local ID sequence and a list of remote ID 
sequences. The local ID sequence identifies the particular computer in which it is established; the remote 
ID sequences identify those remote computers with which a communications link can be established over 
the public telephone network. 


In the :DSLINE command, you can supply (as optional parameters) a local ID sequence and one or more 
remote ID sequences to be used instead of those established during system configuration. (See Figure 2-9.) 


When a telephone connection is established between your HP 3000 and a remote HP 1000, the local ID 
sequence supplied in your :DSLINE command is transmitted to the remote system. The remote system 
then transmits its local ID sequence over the telephone line to your HP 3000. The received ID sequence is 
then compared against the remote ID sequence(s) supplied in your :DSLINE command. If that ID 
sequence is found to be valid, the telephone connection is considered successful and DS/3000 grants you 
access to the line. If the ID sequence received is not considered valid, your : DSLINE request is denied (you 
cannot open the line). 


If you do not supply any ID sequences, DS/3000 uses those established during system configuration. If no 
ID sequences were established during system configuration and you do not supply any, no local ID 
sequence is transmitted from your HP 3000 to the remote system and any remote ID sequence received is 
considered valid. 
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Multiple Users 


Within a DS/3000 environment, it is possible for several users at either end of the line to share access to 
the same physical communications line or for a single user at one end of the line to obtain exclusive access 
to the line. 


As previously mentioned in the discussion of the :DSLINE command, the EXCLUSIVE parameter can be 
used to obtain exclusive access to the specified physical communications line. If you specify this 
parameter (and if access to the line is granted), no other user in either computer will be permitted to open 
that line until you close it. If you ask for exclusive access to a particular line and that line is already in 
use, DS/3000 denies your request (you cannot open the line). (See "Line Opening Failures" later in this 
section. ) 


For hardwired lines and for dial-up lines, multiple users at either end of the line can specify the same 
physical line in :DSLINE commands and obtain access to that line as long as none of them requests 
exclusive access. In such a case, the users’ data is multiplexed, so that each user’s access to the line appears 
to be completely independent of all others. The exception for a telephone line is that all users, other than 
the one who originally opened the line, specify (explicitly or by default) the currently active remote ID 
sequence. Figures 2-7 through 2-11 present annotated examples, illustrating successful and unsuccessful 
attempts by different users to obtain access to the same line. 
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SYSTEM A SYSTEM B 



















SESSION Se ae A | nett ee me ne oe ee Se ~~ SESSION 

| { vocal \ Ue _~ REMOTE 

| \ SESSION SESSION 
~ 





Figure 2-7. Multiple User Example 1 


>HELLO USER.X :HELLO USER.Y 
:DSLINE RSYS1000 :DSLINE RSYS1000 
:REMOTE HELLO USER.X :REMOTE HELLO USER.Y 














In this example, User X initiates a local session in System A, obtains access to the hardwired 
communications line that connects System A to System B, and initiates a remote session in System B. 
User Y subsequently initiates a local session in System A, obtains access to the same communications 
line, and initiates a remote session in System B. The request by User Y for the particular 
communications line is granted by DS/3000 because neither user asked for exclusive access to the line. 


2-22 


The Communications Link 


SYSTEM A SYSTEM B 


RSYS 1000 
SESSION ~~ 


| 
| \ SESSION 
~ 






Figure 2-8. Exclusive Option Example 


sHELLO USER. X :HELLO USER.Y 
:DSLINE RSYS1000;EXCLUSIVE :DSLINE RSYS1000 
:REMOTE HELLO USER.X 


In this example, User X initiates a local session in System A, obtains exclusive access to the hardwired 
communications line that connects System A to System B, and initiates a remote session in System B. 
User Y subsequently initiates a local session in System A and requests access to the same communications 
line. The request is denied by DS/3000 because User X already has exclusive access to the specified 
line. DS/3000 responds with: 


~~ DS LINE IN USE EXCLUSIVELY OR BY ANOTHER SYSTEM. (DSERR 241) 
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Configured Local ID: A Configured Local ID: B 
Configured Remote IDs: B,C Configured Remote IDs: A,C 
SYSTEM A SYSTEM B 












LOCAL RSYS1000 
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Figure 2-9, Dial-up Line Multiple User Example 1 


sHELLO USER.X sHELLO USER.Y 
sDSLINE RSYS1000 & :DSLINE RSYS1000 & 
3; PHNUM=555-1234 & | 3; PHNUM=555-1234 & 
;REMID="B" ;REMID="B" 
:REMOTE HELLO USER.X :REMOTE HELLO USER.Y 


In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DS/3000 
know that the telephone connection was successfully made. 
configured local ID sequences. System A compares the received ID sequence (B) against the remote ID 
sequence specified by User X (REMID="B"). Since the received ID sequence is found to be valid, the 
telephone connection is allowed to remain in effect. User X then initiates a remote session in System B 


over the telephone line from his local log-on terminal. 
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The two computers exchange their 
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User Y subsequently initiates a local session in System A and requests access to the same line 
(RSYS1000). Since that line is already open, DS/3000 ignores the supplied telephone number (no 
message is displayed at the system console). Access to the currently opened line is granted to User Y 
because neither user requested exclusive access and User Y specified the currently active remote ID 
sequence (REMID="B") in his DSLINE command. 
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Configured Local ID: A Configured Local ID: B 
Configured Remote IDs: B,C Configured Remote IDs: A,C ~— 
SYSTEM A SYSTEM B 


RSYS 1000 





Figure 2-10. Dial-up Line Multiple User Example 2 





sHELLO USER.X :HELLO USER.Y 
sDSLINE RSYS1000 & :DSLINE RSYS1000 & 
3 PHNUM=555-1234 & 3;PHNUM=555-2001 & 


;REMID="B" ;REMID="C" 


:REMOTE HELLO USER.X 


In this example User X initiates a local session in System A and obtains access to the line identified by 

the device class name RSYS1000. The supplied telephone number is displayed at the system console of 

System A. The console operator establishes the telephone connection by dialing the number at the 

modem connected to the particular line and then enters YES through the system console to let DS/3000 

know that the telephone connection was successfully made. The two computers exchange their 

configured local ID sequences. System A compares the received ID sequence (B) against the remote ID 

sequence specified by User X (REMID="B"). Since the received ID sequence is found to be valid, the 

telephone connection is allowed to remain in effect. User X then initiates a remote session in System B a 
over the telephone line from his local log-on terminal. 


2-26 


The Communications Link 


can User Y subsequently initiates a local session in System A and requests access to the same line 
Cc (RSYS1000). Since that line is already open, DS/3000 ignores the supplied telephone number and no 
message is displayed at the system console. The request is denied by DS/3000 because the specified line 
is already open and User Y did not specify the auarenily active remote ID sequence (B) in the :DSLINE 

command. DS/3000 responds with: 


COMMUNICATIONS INTERFACE ERROR. UNANTICIPATED CONDITION. (DSERR 255) 
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Configured Local ID: (none) Configured Local ID: (none) 





Configured Remote IDs: (none) Configured Remote IDs: (none) ~ 


SYSTEM A SYSTEM B 
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Figure 2-11. Dial-up Line Multiple User Example 3 


:HELLO USER.X :HELLO USER.Y om, 
:DSLINE RSYS1000 ;PHNUM=555-1234 :DSLINE RSYS1000 ;PHNUM=555-1234 
sREMOTE HELLO USER. XY sREMOTE HELLO USER.Y 


In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DS/3000 
know that the telephone connection was successfully made. No ID sequences are exchanged because 
none were established (in either computer system) during system configuration and User X didn’t specify 


any in the :DSLINE command. User X then initiates a remote session in System B over the telephone 
line from his local log-on terminal. 
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User Y subsequently initiates a local session in System A and requests access to the same line (RSYS1000). 
Since that line is already open, DS/3000 ignores the supplied telephone number (no message is displayed at 
the system console). Access to the currently opened line is granted to User Y because neither user 
requested exclusive access and User Y specified the currently active remote ID sequence (in this case none) 
in his :DSLINE command. 


Note that when no ID sequences are configured and the users don’t supply any in their :DSLINE 
commands, both are taking it on faith that they are connected to the proper remote computer. In this 
example, if User Y had specified PHNUM=555-2001, DS/3000 would have ignored this telephone number 
because the line is already open. User Y would have been connected to the currently active remote 
computer rather than the requested remote system. The total absence of configured or supplied ID 
sequences is safe only under very controlled circumstances. It is strongly recommended that all computers 
in a DS/3000 network that are capable of communicating over telephone lines have default local and 
remote ID sequences established during system configuration and that all line users specify the ID 
sequence of the desired remote computer (REMID=x) in their :DSLINE commands. 


Opening Multiple Lines 


Within your local session, you can open more than one physical communications line and you can have 
remote sessions active concurrently over all of the opened lines. However, when operating without X.25 
Link capability, you are limited to one remote session per physical line at any given time. 


If access to the specified line is obtained, DS/3000 responds to each :DSLINE command by displaying a DS 
line number at your log-on terminal. This line number is roughly analagous to the file number returned 
by the MPE FOPEN intrinsic, in that it is an arbitrary number that uniquely identifies (within your local 
session) your current access to a particular communications line. It has no relationship to the logical 
device number or any other configuration parameter associated with the line. DS line numbers are 
meaningful only if you have more than one line open concurrently within a single local session. In that 
case, you are assigned a separate DS line number for each line you have opened, and you subsequently use 
these numbers to specify which line you wish to use for a given remote command (or sequence of remote 
commands) or to close a particular line without closing the others. 


Figure 2-12 illustrates a situation where a user has established two hardwired communications links 


concurrently from within a single local session. Take a closer look at that situation and examine the 
sequence of commands that was used to create it. 
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SYSTEM A RSYS1 SYSTEM B 
J (DS Line number 3) 











Log—on 
Terminal 


Figure 2-12, Multiple Line Example (Hardwired Lines) 


First, the user sat down at a terminal connected to System A and initiated a local session: 
>HELLO USER. ACCOUNT 
HP3000 / MPE V G.02.00. TUE, OCT 22, 1985, 1:37 PM 


WELCOME TO SYSTEM A. 


USER and ACCOUNT are valid user and account names, respectively as defined by the accounting structure 
of System A. 
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Now, we have the situation illustrated in Figure 2-13. Notice that, at this point, no communications link 


exists between any of the three systems. 


SYSTEM A RSYS1 SYSTEM B 






User’s 
Log-on 
Terminal 


Figure 2-13. Initiating the Local Session 
(Hardwired Example) 
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Next, the user acquired access to a line between Systems A and B. 
:DSLINE RSYS1 
DSLINE NUMBER = #L3 
RSYS1 is the device class name (as defined within System A) associated with the particular line. 


Now we have the situation illustrated in Figure 2-14. 


SYSTEM A RSYS1 SYSTEM B 
a (DS Line number 3) 
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User’s 
Log-on 
Terminal 


Figure 2-14, Establishing the Link With System B 
(Hardwired Example) 
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| Finally, the user acquired access to a line between Systems A and C: 
e :DSLINE RSYS2 
DS LINE NUMBER = #L4 
RSYS2 is the device class name (as defined within System A) associated with the particular line. 


We end up with the situation illustrated in Figure 2-15, which is identical to Figure 2-12 that started 
this example. 





SYSTEM A RSYS1 SYSTEM B 
J Une number 3) 
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Figure 2-15, Establishing the Link With System C 
(Hardwired Example) 
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Figure 2-16 illustrates a situation where a user has established two telephone communications links 
concurrently from within a single local session. Take a closer look at that situation and examine the 


sequence of commands that was used to create it. 


SYSTEM A RSYS1 SYSTEM B 
ye Line number 3) 











User’s 
Log-on 


Terminal 


Figure 2-16. Multiple Line Example (Telephone Lines) 
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First, the user sat down at a terminal connected to System A and initiated a local session: 
:HELLO USER. ACCOUNT 
HP3000 / MPE V- G.02.00. TUE, OCT 22, 1985, 1:37 PM 


WELCOME TO SYSTEM A. 


USER and ACCOUNT are valid user and account names, respectively as defined by the accounting structure 
of System A. 


At this point, we have the situation illustrated in Figure 2-17. Notice that, so far, no communications 
link exists between any of the three systems. 





SYSTEM A RSYS1 SYSTEM B 





User’s 


Log-on SYSTEM C 
Terminal 


Figure 2-17. Initiating the Loca] Session 
(Dial-up Example) 
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Next, the user acquired access to a telephone connection between Systems A and B. 

:DSLINE RSYS1 ;LOCID="A" ;REMID="B" ;PHNUM=257-8001 

DS LINE NUMBER = #L3 
RSYS1 is the device class name (as defined within System A) associated with the particular line, A and B 
are the ID sequences identifying Systems A and B, respectively, and 257-8001 is the telephone number of 


the modem connected to the communications interface at System B. 


Now we have the situation illustrated in Figure 2-18. 


SYSTEM A RSYS1 SYSTEM B 
ye Line number 3) 









User’s 


Log-on SYSTEM C 
Terminal 


Figure 2-18. Establishing the Link With System B 
(Dial-up Example) 


2-36 











The Communications Link 


Finally, the user acquired access to a line between Systems A and C: 
eo :DSLINE RSYS2 ;LOCID="A" ;REMID="C" ;PHNUM=377-2000 
DS LINE NUMBER = #L4 
RSYS2 is the device class name (as defined within System A) associated with the particular line, A and C 
are the ID sequences identifying Systems A and C, respectively, and 377-2000 is the telephone number of 


the modem connected to the communications interface at System C. 


We end up with the situation illustrated in Figure 2-19, which is identical to Figure 2-16 that started 
this example. 





SYSTEM A RSYS1 SYSTEM B 
a Line number 3) 
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Figure 2-19. Establishing the Link With System C 
(Dial-up Example) 
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Line Opening Failures 


There are several reasons why a :DSLINE command for opening a communications line might be rejected 
by DS/3000, some of which have already been illustrated earlier in this section. If the :DSLINE 
command is not executed successfully, the error message may help identify the difficulty. The various 
error numbers and messages that might appear as a result of line opening failures are included in the 
summary of error codes and messages in Appendix A. 


The following list summarizes some likely causes of a line opening failure that are common to hardwired 
lines, leased lines, and dial-up telephone lines: 


You made a syntax error in the :DSLINE command. 

You gave an erroneous line specification (dsdevice) in the :DSLINE command. (There is no IODSO 
or IODSX entry in the system configuration with the specified device class name or logical device 
number. ) 

The line was not opened by the local console operator. 

The line was not opened by the remote console operator. 

Someone already has exclusive access to the specified line. 


You asked for EXCLUSIVE access to a line which was already in use. 


DS/3000 detected a hardware problem (the communications interface board is not responding 
correctly). 


The following list summarizes the additional causes of a line opening failure on a dial-up telephone line: 


The operator was not able to make the requested telephone connection and entered NO through 
the system console in response to the dial request message. 


The remote computer rejected your local ID sequence. 
The remote computer did not send a valid ID sequence (the received ID sequence did not match 
any of the remote ID sequences that you specified or, if you didn’t specify any, did not match any 


of the configured remote ID sequences). 


The specified line is already in use and the remote ID sequence you supplied did not match the 
one used by the currently connected remote HP 1000. 


Things to consider if you have experienced a line opening failure: 


Ensure :DSCONTROL Zdev,OPEN was accomplished. 


Ensure :RU,DINIT has been executed on the RTE system. And, if :DSCONTROL lLdev,OPEN was 
previously done, the: 
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<< HP 3000 COMMUNICATIONS LINK UP >> 


message will be displayed on the HP 1000 system console (displayed only if an HSI interface card 
is used). 


e If previous line activity resulted in an error do :DSLINE lZdev;CLOSE and then try again to open 
the line with a :DSLINE Zdev. 


e In case of continuing problems consider any of the following: 


- Enabling the line from the HP 1000 by :RU,DSMOD and using the /L command to re-enable 
the communication link used to communicate with the 3000. 


- Try to establish a remote session from the HP 1000 to the HP 3000 instead with: 


>RU,RMOTE 
#HELLO... 


( - Try to reenable DS/3000 on the HP 3000 by ending the local session with a BYE command and 
then at the console enter: 


:DSCONTROL Zdev,SHUT 
:DSCONTROL ldev,OPEN 


Next, establish a new local session at the HP 3000 with the HELLO command. 


a The :DSCONTROL Zdev,OPEN allocates the software and establishes the logical links between 
( software modules. 


On the HP 1000, after the DINIT program is executed, an initialization message is sent 
establishing the buffer size. The initialization reply from the HP 3000 results in satisfactory 
completion, and a printing of the message (displayed only if an HSI interface card is used): 


<< HP 3000 COMMUNICATIONS LINK UP >> 
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CLOSING A LINE 


Once you have opened one or more communications lines, you can close any or all of them by using a 
variation of the :DSLINE command. The line closing format of the :DSLINE command is presented here. 


Syntax 


@ 


dsdevice 
:DSLINE <ds-line-number >;CLOSE 





Parameters 

dsdevice (Optional). The device class name, logical device number, or logical node 
name specified in the ;:DSLINE command that opened a particular line. 

ds-lLine-number (Optional) The DS line number assigned to you by DS/3000 when the 
particular line was opened. When this parameter is used, it must appear in 
the format #Ln, where n is the line number (see "Examples" on the 
following page). 

@ (Optional). This parameter specifies that you wish to close all of the lines 
that you currently have open. 

3; CLOSE (Required). This parameter specifies that you wish to close the specified 


line(s). 


If no line identifier (dsdevice, ds-line-number, or @) is specified, DS/3000 closes the line that you 
most recently opened. 


Examples 


The following examples illustrate the variations of the :DSLINE command that can be used for closing 
one or more communications lines. 


:DSLINE RSYS1000 ;CLOSE 


This form closes the line that is identified by the device class name RSYS1000. 
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:DSLINE 55;CLOSE 


This form closes the line that is identified by the logical device number 55. 


:DSLINE @;CLOSE 


This form closes all the lines that you currently have open. 


:DSLINE #L3;CLOSE 


This form closes the line that is identified by #L3. 


:DSLINE;CLOSE 


This form closes the line that you most recently opened. 


If you are sharing one or more physical communications lines with other users, the above forms of the 
:DSLINE command close the line(s) for your application only (the other user’s applications are not 
af fected). 
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SECTION 


REMOTE SESSIONS 





°o 





A communications link exists after you have initiated some activity on the remote HP 1000. If the 
remote HP 1000 system allows session access, the DS/3000 software establishes a remote session using the 
RUSER.RGROUP specified in the REMOTE HELLO or uses the default username and groupname specified in 


the HP 1000 DINIT. answer file. 
NOTE 


If your system does not support session access (HP 1000 A Series running 
RTE-A), you have access to ail system files on the 1000. A REMOTE HELLO 
is not possible. The term session is applied rather loosely in this section to 
differentiate between work done on the local system and work done on the 
remote system (as in local session versus remote session). 


You now have two distinct sessions in existence simultaneously from the same log-on terminal: a local 
session (in the HP 3000 to which you first logged on) and a remote session (at the HP 1000 at the other 
end of the communications line). Now pause for a moment to see what this implies. 


Within the local session, you have access to all I/O devices and disc files in your local HP 3000 (subject to 
the usual MPE file security, of course). This is a normal MPE interactive session in every respect. You 
enter MPE commands and use the various language and utility subsystems exactly as you would if 
DS/3000 were not present. This local session is running under the username, accountname, and 
groupname specified in the : HELLO command that you used to first log on. All user capabilities and file 
access available to you within the local session are determined by those log-on parameters. 


With remote processing, you have access to the RTE operating system in the remote HP 1000 by entering 
RTE operator system commands exactly as you would if you were operating at the HP 1000 and the 
communications link were not present. The RTE operator commands are executed in the remote 
HP 1000, however, the output resulting from the executed commands appears at your log-on terminal. 


NOTE 


Only RTE system commands can be executed. There is no copy of FMGR 
for your session. 


For the sake of clarity and as a learning aid, the remainder of this section will treat local and remote 

sessions as separate (and essentially unrelated) entities that use only those resources available in the 

particular system in which they are running. Actually, it is possible to access the I/O devices and disc 

files of the remote HP 1000 computer from your local session. This more advanced activity will be 
covered in Section 4, "Executing Remote EXEC Calls," and Section 5, "Remote File Access." 
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Remote Sessions 
ISSUING REMOTE COMMANDS 


Remember that, in the previous sections, the following sequence of commands was used to establish the 
communications link: 


RETURN 
>HELLO USER. ACCOUNT 


HP3000 / MPE V G.02.00. TUE, OCT 22, 1985, 9:05 AM 


WELCOME TO SYSTEM A. 
:DSLINE RSYS1000 
DS LINE NUMBER = #L3 


° 
* 


At this point, the remote session has not been initiated; you are currently in the local session (as signified 
by the colon prompt character). To establish a remote session and execute a remote command, use the 
following construct: 


sREMOTE [xxx] command 


where xxx is the DS line number returned by DS/3000 when the communications line was opened, and 
command is the desired RTE command in its normal format. The DS line number is necessary only if you 
have more than one communications line open simultaneously; if it is omitted, then the line which you 
most recently opened is referenced by default. The HP 1000 operator command sent to the remote 
processor must follow the command syntax of the remote processor verbatim, and the first character must 
not be a numeric or a comma. Since different versions of RTE support different operator commands, 
consult the documentation provided with your RTE system to determine the exact format of your RTE 
commands. 


In the example in Section 1, the following construct was used to execute a TI command: 
sREMOTE TI 
1985 330 8 39 3 


Because the prefix REMOTE was included, the TI command is executed in the remote session. Although the 
TI command is executed in the remote HP 1000, the output generated by the command is displayed at 
your local log-on terminal. 


Notice, in the above example, that the DS line number associated with the particular communications line 
was not specified (3 in this example). This is because, if no line number is specified, DS/3000 uses (by 
default) the line most recently opened. Only one communications line is open from your local session; so 
DS/3000 uses that line by default. If you had opened a second line, you would need to tell DS/3000 in 
which remote computer the remote command is to be executed. To tell DS/3000, include the appropriate 
DS line number in the remote command, as follows: 
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Remote Sessions 


:REMOTE 3 TI 


1985 330 8 39 3 


e 
e 


The above construct only allows you to execute a single remote command. After the remote command has 
been executed, control returns to your local session, as signified by the colon prompt character. 


But suppose that you want to execute a whole series of remote commands. It would obviously be a 
nuisance to have to prefix each command with the word REMOTE. DS/3000 provides a convenient 
solution to this situation. To execute a series of commands in the remote session, use the following 
construct: 


sREMOTE [xox] 


where xxx is again the DS line number of the desired communications line (specifying in which remote 
HP 1000 we want to execute commands). DS/3000 then prompts you for each command by displaying a 
# prompt in column 1 of your terminal (in place of the standard MPE colon prompt). In the example in 
Section 1, this construct was used for entering two remote RTE commands, EQ and UP. 


After reviewing the example in Section 1, try this example: 


: REMOTE 
#LU, 1 


LU #1 = E2 
#EQ,2 


16 DVROO O BUOO 
#: 


Notice that except for the # prompt (in place of the standard colon prompt) this looks exactly like a 
normal RTE operator’s session. All of the commands shown in the previous example are entered through 
the local log-on terminal, but the RTE operator commands are executed in the remote session within the 
remote HP 1000. After each remote RTE command was executed, however, control remained in the 
remote session (as signified by the # prompt character). When the user typed a colon (:) in response to 
the # prompt, control was then returned to the local session (as signified by the colon prompt). The 
remote session is terminated when the :DSLINE command is executed with the CLOSE parameter. 
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Remote Sessions 


Executable RTE Operator Commands 


While in a remote process on the HP 1000 system, you can use the RTE operator commands listed below: 


AB Abort current batch program 

BL Set buffer limits 

BR Set break flag in the ID segment of the named program 
DN Declare I/O device unavailable 

EQ Examine status of I/O device 

GO Restart program out of suspension 

IT Set time intervals for programs 

LU Examine or alter device logical unit assignments 
OF Abort a program | 

ON Schedule a program 

PR Change priority of programs 

PS Program status (L, XL, A) 

RU Start a program immediately 

RT Release disc tracks of a program 

Ss . Suspend programs 

ST Examine the status of programs 

TI Display the current time (IVB, 6/VM) 

™ Display the current time (L, XL, A) 

TO Examine or alter time-out parameter of an I/O device 
UP Declare I/O device available 

Io Examine I/O configuration (L, XL, A) 


NOTE 


Extreme care should be taken in modifying the RTE real-time clock since 
some programs, including Distributed System software, are scheduled at 
specific times. 


Syntax and further descriptions of these commands are included in the RTE Programmer's Reference 
Manual for each system. 


Using the Remote Subsystem from a Batch Job 


While in a batch job, you can establish a remote session by using the :DSLINE command. 


3-4 




















Remote Sessions 


The job to be streamed may be similar to the following: 


: JOB USER. ACCOUNT 
:DSLINE RSYS1000 
:REMOTE HELLO RUSER.RACCOUNT 
: REMOTE 

#0N,6 

#T0,6,500 

#UP,6 

#: 

sREMOTE BYE 
:DSLINE;CLOSE 
:EOJ 


NOTE 


The remote # prompt is optional. 


An important point to remember is that, once established, the remote session is interacting with the job in 
the same way as it would interact with a terminal. If the remote session detects an error, the error is 
printed to $STDLIST. If the error generates a user prompt, the next record in the job file is read as the 
response (in the same manner as waiting for a character or carriage return on a terminal). The record is 
then lost to the job. 


ISSUING LOCAL COMMANDS 


Whenever the standard MPE colon prompt is displayed at your terminal, you are in the local session. 
Within the local session, you enter MPE commands in their normal format in response to the colon 
prompt. If you are in the midst of a remote session (that is, you used the command :REMOTE, and 
DS/3000 is issuing the # prompt character), you can return control to your local session by entering a 
colon, as follows: 


#: 


In response to the remote colon, control returns to the MPE Command Interpreter of your local HP 3000 
which then prompts you for local commands with the colon prompt character. Note that the remote 
colon does not terminate the remote session; you can resume processing in the remote session by again 
using either of the constructs described under "Issuing Remote Commands". 


TERMINATING A REMOTE SESSION 


To terminate the remote HP 1000 session, issue the :REMOTE BYE command, or :DSLINE;CLOSE. In the 
latter case, DS/1 000-IV automatically terminates the HP 1000 session. 
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Remote Sessions 
LIMITATIONS 


There are certain limitations when you attempt to access the following RTE subsystems interactively: 


e The Editor. You are unable to edit a file. This is a subsystem that runs under the RTE operating 
system, and there is no facility to direct the dialogue back to the HP 3000 computer. 


e The File Management Program (FMGR). You are unable to run the FMGR control program directly 
with output to an HP 3000 terminal. You may create a transfer file containing the FMGR operator 
commands. Then you may run FMGR, specifying the file as follows: 


#RU, FMGR, TRFILE 
<—____>«<-____» 


Command file in which you have 
stored the FMGR commands 


Command to execute FMGR 
Remote prompt from DS/1000-IV 


Output from the File Manager subystem can not be routed over the communications link back to the 
HP 3000. Instead, all output is directed to LU!. 


The request to RU,FMGR causes the actual FMGR program to run (not a 
copy of it). This will tie up FMGR until the transfer file has completed, 
and keep other users on the HP 1000 from logging on (they will not be able 
to get a copy of FMGR for their session). You must also be very careful to 
EX ,SP from FMGR at the end of the transfer file or FMGR will be tied up 
to your session until you terminate it (BYE), or it times out. Exercise 
caution when running FMGR from the HP 3000. 
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SECTION 


In the RTE operating system environment, EXEC calls are used by programs to interact with the system 
executive. DEXEC calls are the remote processing equivalent to the RTE EXEC calls, allowing you to 
interface with remote systems programmatically. A call to DEXEC will be processed by the EXEC 
module of the remote RTE operating system. 


EXECUTING REMOTE EXEC CALLS 





By using DEXEC calls you can direct the RTE System Executive program to: 
e Read from or write to a remote I/O device (excluding a DISC device). 
e Perform I/O operations on remote I/O devices (excluding a DISC device). 
e Schedule dormant remote programs for execution. 


Obtain the curent time from the remote real-time clock. 


e Schedule remote programs for a set time of execution. 

e Obtain status information about a remote I/O device. 
These calls are summarized in Table 4-1, which lists each DEXEC call with its instruction code and the 
function performed. For further information on DEXEC calls, you may want to refer to the appropriate 


RTE Programmer's Reference Manual which contains information on the nearly identical EXEC calls. 


The programmatic DEXEC calls described in this section can be used from an HP 3000 to an HP 1000. 
Prior to their use, the following commands must first be executed: 


:DSCONTROL Ldev;OPEN Console comand on HP 3000 to enable DS/3000. 


On the HP 1000 to schedule various monitors and to 
:RU,DINIT enable the line. 


In session on the HP 3000 to request the logical use 
:DSLINE Zdev of a DS line to the HP 1000. 
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Executing Remote Exec Calls 


Table 4-1. DEXEC Calls 


Instruction 
code Call Function 
=, = | Reads a record from a remote I/O non-disc device. 
WRITE Writes a record on a remote I/O non-disc device. 
1/O CONTROL Performs an 1/O control operation on a remote I/O 
device. 
a PROGRAM SCHEDULE Schedules dormant remote programs for execution. 











‘4 
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TIME REQUEST Obtains the current time from the remote real-time 
clock. 
TIMED Schedules remote programs for a set time of 
PROGRAM SCHEDULE execution. 
I/O STATUS Obtains I/O status information from a remote I/O 
device. 
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Executing Remote Exec Calls 


DEXEC CALL ELEMENTS 


EXEC calls and DEXEC calls are comparable in certain aspects such as parameter placement and meaning 
and the values returned in ABREG. DEXEC calls do have one additional parameter than EXEC calls. 
This is the destination parameter, named IDEST. The IDEST parameter is a five word integer array which 
contains the device class name or logical device number of the DS device and the DS line number. A 
complete description of IDEST appears for each of the calls in this section. 


NOTE 


In the discussion of each DEXEC call which follows in this section, you may 
be asked to refer to the RTE Programmer's Reference Manual appropriate 
for your HP 1000 system for RTE specific details. You may find that the 
names of the parameters for each call vary slightly depending on which 
RTE manual you reference. 


The format of a typical DEXEC call appears as follows: 


Syntax 


ABREG: = DEXEC (IDEST,ICODE,ICNWD,IBUFR,IBUFL[, IPRM2)); 





DEXEC call formats described in this section include superscripts that describe the types of parameters 
and whether they must be passed by value instead of by reference. The superscripts have the following 
meanings: 


BA byte array 

BP byte pointer 

D double word, by reference 
DA double word array 
DV double word, by value 
I integer by reference 
IA integer array 

IV integer by value 

L logical by reference 
LA logical array 

LV logical by value 

O-V option variable 

R real by reference 
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Executing Remote Exec Calls 


The superscript O-V is shown for some DEXEC calls to denote an option variable, meaning that the 
DEXEC call contains optional parameters. 


Functional Return 


The information returned in the A-register and B-register by DEXEC is the same as that returned by 
EXEC (refer to the appropriate Operating System reference manual) with additional DS/1000-IV error 
conditions and codes. The values of the A- and B-registers are returned immediately after the EXEC call 
is made on behalf of the program on the HP 3000. Applicable DEXEC error codes are listed in Appendix 
A of this manual. 


The following describes the possible outcomes : 


e CCL({<) Error detected by the HP 3000. The binary code in ABREG may contain a 
DEXEC, DS, or MPE file system error code. 


e CCG(>) Completed at communications level, but the HP 1000 detected an error. A four 
character ASCII DEXEC error code is in ABREG. 


e CCE(=) The call was completed successfully. Registers contain status information, not 
error information. 


Error Checking Routine Example 


The following example shows how to check for the failure of a DEXEC call. This example comes from a 
complete programming example that appears at the end of this section. You will need to refer to the 
complete programming example for the definition of the variables. 


PROCEDURE ERROR(CC,QUITNO) ; 
VALUE CC ,QUITNO; 
INTEGER CC,QUITNO; 


BEGIN 
IF CC=-1 THEN <<DEXEC RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 DEXEC ERROR: "; 
ASCII (ABREG(1),10,MSG(24)); 
PRINT (MSGW,-25,0); 
END 
ELSE IF CC=1 THEN <<DEXEC RETURNED CCG>> 
BEGIN 
MOVE MSG:="## HP 1000 DEXEC ERROR: "; 
MOVE MSGW(12):=ABREG, (2); 
PRINT (MSGW, 14,0); 
END; 
QUIT (QUITNO) ; 
END; 











Executing Remote Exec Calls 


NOTE 


For detailed information about DEXEC calls, refer to the DS/1000-IV 
User's Manual and the EXEC call section of the RTE Programmer's 
Reference Manual appropriate for your system. 
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READ 


The read call, instruction code 1, transfers information from a remote I/O device to a local user buffer. 


Syntax 


D 


LA IV I IA I I I 0-V 


ABREG: = DEXEC (IDEST,ICODE,ICNWD,IBUFR,IBUFL[ 


Functional Return 





Upon completion of the call, a doubleword ABREG is returned. Word 1, displayed in the A-register, 
contains status information, the equipment type code, and an availability indicator. Word 2, displayed in 
the B-register, shows the positive number of words or characters actually read, depending on how IBUFL 
was specified in the procedure call (+ for words, - for characters). Refer to the appropriate RTE 
Programmer's Reference Manual for details. 


Parameters 


IDEST 


ICODE 


ICNWD 


IBUFR 


IBUFL 


IPRM1 and IPRM2 


Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 


Integer by value (required). Specifies the instruction code, which is 1 for a 
read call. 


Integer by reference (required). The control word is an integer which 


specifies the logical control unit of the remote input device and other 
control information required by RTE. 


Integer array (required). An array that will contain the information read 
from the device. You must insure the buffer is large enough to hold the 
amount of data specified by ZBUFL. 


Integer by reference (required). An integer specifying the number of words 
or characters to be read. If this value is positive it signifies the length in 
words; if it is negative it signifies the length in characters. The maximum 
buffer size for DEXEC requests is 512 words (1024 characters). 


Integer by reference (optional). Integer parameters which may be optional, 
depending on the input device. Unlike a local RTE EXEC call, these 
parameters cannot be used to pass additional buffers. 





> 


























READ 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 
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WRITE 


The write call, instruction code 2, transfers information from a local user buffer to a remote I/O device. 


Syntax 


D 


Functional Return 


LA IV I IA I I I 0-V 





Upon completion of the call, a doubleword ABREG is returned. Word 1, displayed in the A-register, 
contains status information, the equipment type code, and an availability indicator. Word 2, displayed in 
the B-register, shows the positive number of words or characters actually read, depending on how IBUFL 
was specified in the procedure call (+ for words, - for characters). Refer to the appropriate RTE 
Programmer's Reference Manual for details. 


Parameters 


IDEST 


ICODE 


ICNWD 


IBUFR 


IBUFL 


IPRM1 and IPRM2 
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Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 


Integer by value (required). The instruction code is 2 for a write call. 


Integer by reference (required). The control word is an integer which 
specifies the logical control unit of the remote input device and other 
control information required by RTE. 


Integer array (required). An array that will contain the information read 
from the device. You must insure the buffer is large enough to hold the 
amount of data specified by IBUFL. 


Integer by reference (required). An integer specifying the number of words 
or characters to be read. If this value is positive it signifies the length in 
words; if it is negative it signifies the length in characters. The maximum 
buffer size for DEXEC requests is 512 words (1024 characters). 


Integer by reference (optional). Integer parameters which may be optional, 
depending on the input device. Unlike a local RTE EXEC call, these 
parameters cannot be used to pass additional buffers. 




















WRITE 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE 


CCL 


CCG 


Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 


Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 
binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 


1/0 CONTROL 


The I/O control call, instruction code 3, carries out various operations such as backspace, rewind, and end 
of file, on a remote I/O device. 


Syntax 


D LA IV I I 0-V 





Functional Return 


The call returns the A-register and B-register in a double word. The A-Register contains the status of 
the device and EQT word 5. The B-Register has no meaning. Refer to the appropriate RTE 
Programmer's Reference Manual for details. 


Parameters 

IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

ICODE Integer by value (required). The instruction code is 3 for an I/O control 
call. 

ICNWD Integer by reference (required). The control word is an integer which 
specifies the logical unit of the remote I/O device and other control 
information information required by RTE. 

I PRM? Integer by reference (optional). An optional parameter which is required 


for list output line spacing and various other functions. 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 





PROGRAM SCHEDULE 


The remote program schedule call, instruction code 10, designates a dormant remote program for 
execution at the remote system and optionally transfers up to five parameters to the program. 





Syntax 


D LA IV IA I I I 





Functional Return 





If the program to be scheduled is dormant, it is scheduled by this call and a zero is returned to the calling 
program in the A-Register. 


If the program to be scheduled is not dormant, it is not scheduled by this call and its status, which is some 
non-zero value, is returned to the calling program in the A-Register. 





A-register: Meaning: 
0 Good return. 
1 Program already scheduled. 
2 I/O suspend. 
3 Program in wait state. 
4 Unavailable memory suspend. 
5 Disc allocation suspend. 
6 Operator suspend, or program suspend. 





Parameters 

IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

ICODE Integer by value (required). The instruction code is 10 for a program 
schedule call. 

INAME Integer array (required). A five character name array of the program to 
schedule. 

IPRM?1 - IPRM5 Integer by reference (optional). Up to five integer parameters to be passed 


to the scheduled program. 





PROGRAM SCHEDULE 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE 


CCL 


CCG 


Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 


Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 
binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 




















TIME REQUEST 


The time request call, instruction code 11, obtains the current time from the remote real-time clock and 
returns it to your terminal. 


Syntax 


D LA IV IA 


ABREG: = DEXEC (IDEST,ICODE[,ITIME]); 





Parameters 

IDEST Logical array (required). A five word array that contains, in its first four 
words an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

ICODE Integer by value (required). The instruction code is 11 for a time request 
call. 

ITIME Integer array (required). A five word array in which the current time is 
returned. 


ITIME (1) = tens of milliseconds 
ITIME (2) = seconds 

ITIME (3) = minutes 

ITIME (4) = hours 

ITIME (5) = day of year (Julian) 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 


TIMED PROGRAM SCHEDULE (Initial Offset) 


The remote timed program schedule call, instruction code 12, schedules a remote program for execution at 
specified time intervals, starting after an initial offset time. The requested program is placed in the time 
list. 


Syntax 


D LA IV TA I I I 


ABREG: = DEXEC (IDEST,ICODE,INAME ,IRESL ,MPTLE,IOFST) ; 





Parameters 


IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 


ICODE Integer by value (required). The instruction code is 12 for a remote timed 
program schedule call. 


INAME Integer array (required). A three word integer array which names the 
remote program to put in the time list. 


IRESL Integer by reference (required). The value of resolution represents the units 
of time which, when used with the MTPLE value, result in the total time 
intervals. Values for the resolution code are: 


1 = tens of milliseconds 
2 = seconds 

3 = minutes 

4 = hours 


MTPLE Integer by reference (required). Multiple is a number from 0 to 4095 
which is used with IRESL to give the actual time interval for scheduling. 
For example, if MTPLE is set to 3and JARESL is 2, the program will be 
scheduled every 3 seconds after an initial offset of ZOFST seconds. If the 
parameter MTPLE is set to zero, the program is run only once. 


IOFST Integer by reference (required). JOFST is used with the value of IRESL to 
define the initial time offset. It is a negative value representing the 
amount of time to wait before running the program for the first time. 


TIMED PROGRAM SCHEDULE (Initial Offset) 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 








I/O STATUS 


The I/O status call, instruction code 13, obtains I/O status information about a remote I/O device. 





Syntax 


D LA IV I L L 0-V 


ABREG: = 











Parameters 

IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

ICODE Integer by value (required). The instruction code is 13 for an I/O status 
call. 

ICNWD Integer by reference (required). The control word is an integer which 
specifies the logical unit of the remote I/O device and other control 
information required by RTE. 

ISTA] Logical (required). The status returned for EQT word 5. See the 
appropriate RTE Programmer's Reference Manual for details. 

ISTA2 Logical (optional). The status returned for EQT word 4. See the 


appropriate RTE Programmer's Reference Manual for details. 


Error Conditions 





Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 





PROGRAM EXAMPLE 


The following is an SPL program which uses the read and write DEXEC calls and also includes an error 


( ; checking routine. 


$CONTROL USLINIT 
BEGIN 


COMMENT 
THIS PROGRAM PROMPTS THE USER FOR A MESSAGE TO BE 
WRITTEN TO THE REMOTE HP 1000 CONSOLE, AND THEN 
READS THE REMOTE HP 1000 OPERATOR’S RESPONSE. THE 
RESPONSE IS PRINTED ON THE HP 3000 USER’S TERMINAL; 


BYTE ARRAY BBUFFER(0:79); 

BYTE ARRAY MSG(0:79) ; 

ARRAY DESTINATION(0:4):="NODE105 "s 
ARRAY MSGW(#)=MSG; 

INTEGER ARRAY BUFFER(*)=BBUFFER; 
DOUBLE ABREG; 

INTEGER LGTH; 








PROCEDURE ERROR(CC,QUITNO) ; 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 


( BEGIN 


IF CC=-1 THEN <<DEXEC RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 DEXEC ERROR: "; 
ASCII (ABREG(1),10,MSG(24)); 
PRINT (MSGW,-25,0); 


END 
ELSE IF CC=1 THEN <<DEXEC RETURNED CCG>> 
BEGIN 
‘a MOVE MSG:="## HP 1000 DEXEC ERROR: "; 
MOVE MSGW(12):=ABREG, (2); 
PRINT (MSGW, 14,0); 
END; 
QUIT (QUITNO) ; 
END; 
LOOP: 


<<PROMPT USER FOR MESSAGE TO BE SENT TO REMOTE OPERATOR>> 


MOVE MSG:="ENTER MESSAGE FOR HP 1000 OPERATOR: “; 
PRINT (MSGW, -36 ,%320) ; 

LGTH: =READ( BUFFER, -80) ; 

IF (LGTH=0) THEN TERMINATE; 


PROGRAM EXAMPLE 


<<SEND MESSAGE TO THE HP 1000 SYSTEM CONSOLE>> 


IF < THEN ERROR(-1,1) 
ELSE IF > THEN ERROR(1,2); 


<<READ REMOTE OPERATOR’S RESPONSE>> 


IF < THEN ERROR(-1,3) 

ELSE IF > THEN ERROR(1,4); 
PRINT (BUFFER, -ABREG(2) ) ; 
GO LOOP; 


END. 
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SECTION 


REMOTE FILE ACCESS 


oo 


Through the use of the DS/3000 Remote File Access capability, SPL, PASCAL, FORTRAN, or COBOL/II 
programs running in your local session can access any of the disc files of the remote HP 1000 (which are 
available to your session) as though they reside at your local HP 3000 site. 


NOTE 


RFA calls can only access FMGR files; you cannot access files in the 
hierarchical file system. 


This section discusses how you can use HP 3000 intrinsics to access HP 1000 files using DS. 
PROGRAMMATIC ACCESS 


Once a communications link has been established between your HP 3000 and remote HP 1000, you can 
use the Remote File Access (RFA) intrinsics to access files available to your session which reside at the 
remote HP 1000 site. Remote File Access provides the means to create, open, read, write, close, and 
control the files on the remote HP 1000 system. 


Table $-1 lists the Remote File Access intrinsics, the corresponding RTE File Manager (FMP) call, and a 
corresponding description of each RFA intrinsic call. Refer to the RTE Programmer's Reference Manual 
for further information on FMP calls. 
These RFA intrinsics may be used from the HP 3000 to an adjacent HP 1000. Use of these intrinsics 
requires that the line be opened by the commands: 
:DSCONTROL Zdev;OPEN Console comand on HP 3000 to enable DS/3000. 
:RU,DINIT On the HP 1000 to schedule various monitors and to 


enable the line. 


:DSLINE Zdev In session on HP 3000 to request the logical use of a 
DS line to the HP 1000. 


NOTE 


Multiple processes running under the same HP 3000 session cannot access 
the same HP 1000 file via RFA. 


Multiple processes under separate HP 3000 sessions may access the same 
HP 1000 file via RFA. 
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Remote File Access 


Table 5-1. RFA and FMP Cross Referencing 


DESCRIPTION 


Positions disc files to a record. Record address usually 
obtained through DLOCF. 


Close DCB. Make file available to others. Can also 
truncate file. 


Perform I/O control function on non-disc device file, a 
type 0 file. 


Create a file. 


Return information on opened file. 


Close DCB and rename file. 


Open file to calling program. 


Skip records forward or backward. 


Purge file. Cannot be opened. 


Read a record from a file to a user buffer. 


Return status of all mounted cartridges. 


Rewind type 0 files, including magnetic tape. Set to 
record 1 in disc file. 


Write a record from the buffer of a user to file. 





























Remote File Access 


DESCRIPTION OF ERROR CONDITIONS AND PARAMETERS 


CCE No error with DS/3000 at either end. Check JERR for result on the HP 1000. If IERR< 0, 
then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 

CCG Not used. 

IERR Integer (required). The error code returned as a result of remote file access problems. 


The following example shows how to check for the failure of an RFA call. The example comes from a 
complete programming example that appears at the end of this section. 


Error Checking Routine Example 


PROCEDURE ERRORPROC (CC ,QUITNO) ; 
VALUE CC ,QUITNO; 
INTEGER CC,QUITNO; 


BEGIN 
MOVE MSG(0):=" "; 
MOVE MSG(1):=MSG(0), (59); 
IF CC=-1 THEN <<RFA RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22) ); 
PRINT(MSGI,-25,0); 
END 
ELSE IF CC=0 THEN <<RFA RETURNED CCE WITH ERROR>> 
BEGIN 
MOVE MSG:="## HP 1000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22)); 
PRINT (MSGI, -25,0); 
END; 
QUIT (QUITNO) ; 
END; 
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Remote File Access 
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NOTE 


If the file being accessed at the remote HP 1000 site is particularly large, 
you may get an error message at the HP 3000 site which indicates a remote 
reject error. In fact, the problem may be that a time out occurred at the 
remote HP 1000 site. The HP 3000 does not have an error message to 
indicate that this is the real problem. You may wish to verify a time out 
problem by looking at the error message that appears on the HP 1000 
system console or simply up the time out specificaton. Refer to the 
DS/1000-IV Network Manager's Manual, Vol. II for details. 


NOTE 


For detailed information on RFA calls, refer to the DS/1000-IV User's 
Manual and the RTE Programmer's Reference Manual appropriate for your 
system. 

















DAPOS 


Sets the address of the next record for sequential RTE disc file. 


Syntax 


LA I Iv. IV IV 0-V 


DAPOS (IDCB,IERR,IREC[ 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a 4-word array 
used for each RTE file opened. This is used by the system and should not 
be modified. 

IERR Integer (required). Error code returned as the result of remote file access. 

IREC Integer by value (required). Record number of the next record in a 
sequentially numbered file. The first record is numbered starting with 1. 

IRB Integer by value (optional). Relative block number of the block containing 
the next record, from the DLOCF intrinsic. This parameter must be 
included for correct operation on files with variable length records. 

IOFF Integer by value (optional). A word offset, within a block, for the 


beginning of a new record, from DLOCF intrinsic. This parameter must be 
included for correct operation on files with variable length records. 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check JERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 


NOTE 


The DAPOS intrinsic allows random access of sequential files. 
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DCLOS 


Closes the DCB and makes the RTE file available to other callers. 


Syntax 


LA I IV 0-V 


DCLOS (IDCB,IERR[: 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each file opened. This is used by the system and should not 
be modified. 

IERR Integer (required). The error code returned as a result of remote file access. 

ITRUN Integer by value (optional). The number of blocks in the file to truncate: 


+N number of blocks to be deleted from the end of the file. 
-N delete all extents and retain the main file. 


0 the standard close; file closed without truncation. 


If the number of blocks specified in ITRUN is 
equal to the number of blocks in the file, the 
file is purged. 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check TERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 
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DCLOS 


a NOTE 


The DCLOS intrinsic closes the Data Control Block, and makes the RTE file 
available to other callers. It also gives the user the option of truncating the 
file size when: 

e The file is opened exclusively. 

e The current position is in the main file, not in the extent. 


e The security codes match at open. 


e The number of blocks to be truncated is less than or equal to the number 
of blocks in the file. 








DCONT 


Sends standard RTE I/O control request to RTE type 0, non-disc, file. 


Syntax 


LA TI IV IV Q-V 





Parameters 

I0CB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error codes returned as a result of remote file access. 

ICON? Integer by value (required). Control word specifying an action, such as, 
backspace one record or skip a line. See the appropriate RTE Programmer's 
Reference Manual for details. 

ICON2 Integer by value (optional). This value is required for some of the functions 


defined in ICON7, for example, to define the number of lines to be skipped. 
Refer to the appropriate RTE Programmer's Reference Manual for details. 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check ZERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 




















DCRET 


Closes the DCB, if open, and creates the named RTE file on the specified disc with the specified number of 
blocks. 


Syntax 


LA I LA LA IV IV LA O-V 





Parameters 
IDcB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 
IERR Integer (required). Number of sectors or error code returned as a result of 
remote files access. 
NAME Logical array (required). RTE file name consisting of up to six characters. 
ISIZE Logical array (integer). Two word integer array. Word 1 specifes the 
number of blocks desired. If the number of blocks is less than 0, the whole 
disc is used. Word 2, used only for type 2 files, contains the record length 
in words. 
Word 1: The number of blocks desired. 
Word 2: The record length in words. Type 2 files. 
ITYPE Integer by value (required). Description of the file. 
0 non-disc file 
] fixed length 128-word record 
2 fixed length records; user defines length 
3 variable length records; sequential access, automatic 
extents 
4 ASCII code and source program (otherwise like type 3 
files) 
5 relocatable binary code (otherwise like type 3 files) 
6 save program file (otherwise like type 1 files) 
7 absolute binary (otherwise like type 3 files) 
8 - 32767 user defined 


DCRET 


ISECU Integer by value (optional). Two character security code of the file. If 0, 
no security (default value); if > 0, any may read, specify to write; if < 0, 
specify to read/write. 





ICR Logical array (optional). Cartridge number; required during the first 
create. A five word array where: 


ICR [0] If O, use any available cartridge; if >0, 
cartridge reference number; if <0, LU of the 
cartridge. 


ICR (1)-[4] ASCII representation of the DS device class 


name, logical device number, or node name for 
DS/X. 25. 


See the DS/1000-IV User's Manual for greater detail. 





Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 
CCE No error with DS/3000 at either end. Check IERR for result on the HP 1000. If TERR < 


0, then there isan FMP error. DCRET will return a positive value in TERR upon successful 
completion to represent the number of sectors allocated to the file. 





CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 


NOTE 


The RTE file created by the DCRET intrinsic is left open 
exclusively to the caller upon successful completion of the 
intrinsic call. 





This intrinsic does not create a type O file. These are device files, such as line printers or card readers. 
Type 0 files may be created only by FMGR commands at the HP 1000. 











DLOCF 


Remotely accesses a DCB maintained in RTE to obtain location and status information about the next 
record. 


Syntax 


LA I I I I I 0-V 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). The error code returned asa result of remote file access. 

IREC Integer (required). Returns the record number of next sequential record. 
Record numbers begin with 1. 

IRB Integer (optional). Returns the block number of the current block. 

IOFF Integer (optional). Returns a word offset, within the current block, at 
which the next record will begin. 

JSEC Integer (optional). Returns the number of sectors in the main file. 

JLU Integer (optional). Returns the logical unit number of the file on disc, or of 
the non-disc device for type 0 files. 

JTY Integer (optional). Returns the file type as indicated in DCB. 

JREC Integer (optional). Returns the record size in words, For type 0 files a 


read/write code is returned as follows: 


0123 45 6 7 8 9 10 11 12 13 14 #15 


Ww | Reserved PR 


R Read (Bit 15) = 1 
W Write (Bit 0) = 1 


DLOCF 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE 


CCL 


CCG 


No error with DS/3000 at either end. Check JERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


Not used. 

















DNAME 


Closes the DCB, if open, and renames the specified RTE file. 


Syntax 


LA I LA LA 





Parameters 

IDcB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error code returned as a result of remote file access. 

NAME Logical array (required). Current RTE file name up to six characters. 

NNAME Logical array (required). New RTE file name up to six characters. 

ISECU Integer by value (optional). Two character security code of the old file. 
Remains unchanged. 

ICR Logical array. Required if file is currently open to user. A five word array 


where: 


ICR [0] Cartridge number. If specified the search is limited to 
just that cartridge. If not specified all cartridges are 
searched, but only the first file encountered with the 
old name is changed. 


ICR [(1)-[4] ASCII representation of the DS device class name, 
logical device number, or node name for DS/X.25. 
DSLINE. 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE 


CCL 


CCG 


No error with DS/3000 at either end. Check JERR for result on the HP 1000. If TERR< 
0, then there is an FMP error. 


Indicates problems at the HP 3000end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


Not used. 


DOPEN 


Closes the DCB, if open, and opens the named RTE file. 


Syntax 


LA tI LA IV IV LA 0-V 





Parameters 

IdcB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). The file type or error code returned as a result of 
remote file access. 

NAME Logical array (required). RTE file name assigned to file of up to six 
characters. 

IOPTN Integer by value (optional). This value specifies non-standard conditions 
desired when opening a file. See the DS/IO00-IV User's Manual for 
details of the file options available. 

NOTE 
The parameter IJOPTN for: 
e A type 2 file must be modified in update 
mode. 
e A type 3, and greater, file is modified in a 
non-update mode, and writes an EOF 
after each record. 
ISECU Integer by value (optional). Two character or binary security code of the 


file. If 0, no security (default value); if > 0, any may read, specify to write; 
if < 0, specify to read/write. 




















ICR 





DOPEN 


NOTE 


If the file was created (see DCRET call) with a 
non-zero security code, this parameter must 
be specified and it must match the original 
security code assigned to the file. 


Logical array (required during first open). A five word array where: 
ICR [0] Cartridge number. 
ICR (1)-[4] ASCII representation of the DS device class name, logical 


device number, or node name for DS/X. 25. 


See the DS/1000-IV User's Manual for details (RFA Call Parameter 
Variations). 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


o CCE 


CCL 


CCG 





No error with DS/3000 at either end. Check ZEAR for result on the HP 1000. If ZERR< 
0, then there is an FMP error. DOPEN will return a positive value if the call is successfully 
completed to represent the file type. 


Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


Not used. 


DPOSN 


Skips forward or backward a specified number of records, or to an absolute record number. 


Syntax 


LA I IV 0-V 


DPOSN (IDCB,IERR,NUR[,IR)); 





Parameters 
IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 
IERR Integer (required). Error code returned as a result of remote file access. 
NUR Integer by value (required). The number of records to be skipped from the 
current file pointer position: 
+N number of records forward 
-N number of records backward 
0 no operation 
IR Integer by value (optional). The absolute or relative position of the record: 


0 = NUR indicates a relative position. Default value. 


1=NUR itidicates an absolute record number within the file. 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check ZERR for result on the HP 1000. If ZERR< 
0, then there is an FMP error. . 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 




















DPURG 


Closes the DCB, if open, and deletes the named RTE file and all its extents. 


Syntax 


LA 


LA IV LA O-V 





Parameters 


IdCB 


IERR 


NAME 


ISECU 


ICR 


Error Conditions 


Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 


Integer (required). Error code returned as a result of remote file access. 


Logical array (required). RTE file name consisting of up to six characters 
that identifies the file to be purged. 


Integer by value (optional). Two character security code of the file. If 0, 
no security (default value); if > 0, any may read, specify to write; if < 0, 
specify to read/write. 


Logical array (required if file not presently open to the user). A five word 
array where: 


ICR [0] Cartridge number. 


ICR [1]-[4] ASCII representation of the DS device class name, 
logical device number, or node name for DS/X. 25. 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check JERR for result on the HP 1000. If TERR < 
O, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 


DREAD 


Reads a record from the RTE file currently open to DCB, to the user buffer. 


Syntax 


LA I LA IV I 0-V 


DREAD (IDCB,IERR,IBUF ,IL[ 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). The error code returned from accessing remote file. 

IBUF Logical array (required). The buffer to which data is read. 

Il Integer by value (required). A read request buffer length that specifies the 
number of words to be transferred. The buffer size is limited to $12 
words. 

LEN Integer (optional). Actual number of words transferred to the 
buffer. If length = -1, an end of file was read. 

NUM Integer by value (optional). Record number for random access type 1 and 


type 2 files: 
If NUM= 0, transfer starts at current pointer position (default). 


If NUM> O, transfer starts at absolute record position. 
If NUM < O, transfer starts at current position. 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check JERR for result on the HP 1000. If IERR< 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 
































DSTAT 


Returns information on all cartridge labels in the RTE system. 


Syntax 


LA I LA 0-V 


DSTAT (ISTAT,IERR,IDEST); 





Parameters 

ISTAT Logical array (required). A 125-word buffer for directory information. 
See the appropriate RTE Programmer's Reference Manual for details. 

IERR Integer (required). Error code returned as a result of remote file access. 

IDEST Logical array (required). ASCII representation of the DS device class name, 


logical device number, or node name for DS/X.25 (4-word array). 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check JERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 


DWIND 


Rewinds RTE device type 0 files and resets RTE disc files to the beginning of the first record in the file. 


Syntax 


LA so 0-V 


DWIND (IDCB,IERR); 





Parameters 

Tdc8 Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error code returned as a result of remote file access. 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check JERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 


5-20 




















DWRIT 


Writes a record on the RTE file currently open to the DCB from the user buffer. 


Syntax 


LA I LA IV IV 0-V 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error code returned as a result of remote file access. 

IBUF Logical array (required). Buffer from which data is written to record. 

Il Integer by value. Number of words from I8UF to be written. The buffer 
size 18 limited to 512 words. 

NUM Integer by value (optional). Record number for random access type 1 and 


type 2 files: 
If NUM= 0, transfer starts at current pointer position (default). 


If NUM> O, transfer starts at absolute record position. 
If NUM < 0, transfer starts at current position. 


Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DS/3000 at either end. Check JERR for result on the HP 1000. If ZERR< 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DS/3000 subsystem or MPE file system error. 


CCG Not used. 
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RFA EXAMPLE: SPL 


The following SPL/3000 program shows how remote files can be accessed using the remote file access calls 
to pass files between the HP 3000 and the remote HP 1000. 


$CONTROL USLINIT 
BEGIN 


COMMENT 


THIS PROGRAM TRANSFERS ONE ASCII RTE FILE TO AN MPE FILE. BECAUSE 

OF DIFFERENCES BETWEEN RTE AND MPE FILE FORMATS, THE RTE FILE IS 
TRANSFERRED AS 72-CHARACTER UNNUMBERED RECORDS. THE USER IS PROMPTED 
FOR THE NAME OF AN RTE FILE OR /E TO EXIT THE PROGRAM. AFTER THE RTE 
FILE IS OPENED, THE PROGRAM PROMPTS FOR THE NAME OF A NEW MPE FILE OR 
/E TO EXIT THE PROGRAM. THE PROGRAM THEN CREATES THE MPE FILE AND THE 
RECORDS ARE TRANSFERRED FROM THE RTE FILE TO THE MPE FILE. 

UPON COMPLETION, THE PROGRAM PRINTS THE NUMBER OF RECORDS 

TRANSFERRED AND TERMINATES; 


INTEGER FILENUM,ERROR,I,LGTH; 
INTEGER NORECORDS: =0; 


LOGICAL OPEN ,MOREDATA: =TRUE; 


INTEGER ARRAY DCB(0:4), 
, BUFFER(0:32), 
FILENAME (0:13), 
CRN(0:4); 


BYTE ARRAY MSG(0:59); 
BYTE ARRAY NUMBER(0:5); 
BYTE ARRAY FILENAMEB(#*)=FILENAME; 


ARRAY MSGI (#)=MSG; 
ARRAY NUMBERI(#*)=NUMBER; 


ASCII 






INTRINSIC FOPEN, FWRITE, FCLOSE, PRINT, READ 
PRINT’FILE’INFO, QUIT, | DOPEN 


PROCEDURE ERRORPROC(CC,QUITNO) ; 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 


BEGIN 
MOVE MSG(0):=" "5 
MOVE MSG(1):=MSG(0), (59); 
IF CC=-1 THEN <<RFA RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22)); 
PRINT(MSGI,-25,0); 
END 
ELSE IF CC=0 THEN <<RFA RETURNED CCE WITH ERROR>> 
BEGIN 
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RFA EXAMPLE: SPL 


MOVE MSG:="## HP 1000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22)); 
PRINT(MSGI,-25,0); 
END; 
QUIT (QUITNO) ; 
END; 





<<BEGIN MAIN CODE>> 


<<PROMPT USER FOR RTE FILE NAME, 
CARTRIDGE REFERENCE NUMBER AND DSLINE>> 
OPEN: =FALSE; 
WHILE NOT OPEN DO 
BEGIN 
MOVE MSG:="ENTER NAME OF RTE FILE: "3 
PRINT (MSGI ,12,%320) ; 
MOVE FILENAMEB:=28(" "); 
READ (FILENAME,-6); 
IF FILENAME(0)="/E" THEN GO TO ENDIT; 





MOVE MSG:="ENTER CARTRIDGE REFERENCE NUMBER: "; 
PRINT (MSGI ,17,%320) ; 

MOVE NUMBER:=6(" "); 

READ(NUMBERI, -6) ; 

CRN(0):=BINARY (NUMBER,6) ; 


MOVE MSG:="ENTER THE DS DEVICE LDEV OR CLASS NAME: "3 
PRINT (MSGI ,20 ,%320) ; 

MOVE CRN(1):=4(" "); 

READ(CRN(1),-8)3 











 DOPEN (DCB,ERROR,FILENAME ,%100,0,CRN) ; 
IF < THEN ERRORPROC(-1,1); 

IF ERROR < O THEN ERRORPROC(0,2); 
OPEN: =TRUE; 


END; 





<<PROMPT FOR MPE FILE NAME AND CREATE IT>> 
OPEN: =FALSE; 
WHILE NOT OPEN DO 
BEGIN 
MOVE MSG:="ENTER NAME OF MPE FILE: "; 
PRINT (MSGI ,12,%320) ; 
MOVE FILENAMEB:=28(" "); 
READ(FILENAME ,-28); 
IF FILENAME(0)="/E" THEN GO TO ENDIT; 
FILENUM: =FOPEN (FILENAMEB, 4,%344, 36) ; 
IF < THEN PRINT’ FILE’ INFO(FILENUM) 
ELSE OPEN:=TRUE; 
END; 


<<TRANSFER DATA>> 
MOREDATA: =TRUE ; 
WHILE MOREDATA DO 
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THEN ERRORPROC(-1,3); 
IF ERROR < O THEN ERRORPROC(0,4); 
IF LGTH=-1 THEN MOREDATA: =FALSE 
ELSE 
BEGIN 
FOR I:=LGTH+1 UNTIL 35 DO BUFFER(I):=" "s 
FWRITE(FILENUM, BUFFER(1),36,0); 
IF <> THEN 
BEGIN 
PRINT FILE’ INFO(FILENUM) ; 
MOREDATA:=FALSE; 
END 
ELSE NORECORDS: =NORECORDS+1; 
END; 





THEN ERRORPROC(-1,5)3 

IF ERROR < 0 THEN ERRORPROC(0,6); 

FCLOSE (FILENUM,%11,0); 

MOVE MSG(0):="_"; 

MOVE MSG(1):=MSG(0), (59); 

MOVE MSG:="NUMBER OF RECORDS TRANSFERRED = "; 
ASCII (NORECORDS , 10 ,MSG(32)); 

PRINT (MSGI, 18,%40) ; 








END. 
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RFA EXAMPLE: FORTRAN 


The following FORTRAN program shows how to create a file on the remote HP 1000. 





$CONTROL INIT 
PROGRAM RFATR 
C THIS PROGRAM CREATES A NEW FILE ON THE RTE SYSTEM. 
C IT PROMPTS FOR INPUT, AND WRITES EACH RECORD 
C INTO THE NEW FILE USING RFA INTRINSICS. 
C UPON COMPLETION IT DISPLAYS THE CONTENTS, 
C AND CLOSES, AND TRUNCATES THE FILE. 


Cc 
Cc 
INTEGER BLOCKNUM, IERR, IERROR, ISIZE, LENGTH 
INTEGER OPTN, RECNM, SECURITY 
INTEGER TRUNCATE, TYPE 
Cc 
LOGICAL CRTNM(S), DCB(4), NAME(3), SIZE(2) 
cc LOGICAL BUFFER(40) 
Cc 
CHARACTER ANSW(6), BUFBYTE(72), BUFCHAR#72 
CHARACTER CRTBYTE(8) ,FORMALDES#8 
INTEGER BUFINTG(2) 
LOGICAL BUFPRNT(40) 
Cc 


EQUIVALENCE (BUFFER, BUF BYTE) 

EQUIVALENCE (BUFFER, BUFINTG) 

EQUIVALENCE (BUFFER ,BUFCHAR) 
eo EQUIVALENCE (CRTNM(2) ,CRTBYTE) 








C 
SYSTEM INTRINSIC BEEGS! BERET! BEGGE! BBPEN 
SYSTEM INTRINSIC [ 
SYSTEM INTRINSIC F ; 
SYSTEM INTRINSIC FREAD 
C 


DATA FORMALDES/8H$STDINX / 


##### MAIN PROGRAM ####4 


aan 


WRITE(6,102) 
102 FORMAT(" BUILD FILE ON REMOTE RTE SYSTEM.") 
WRITE(6,112) 
112 FORMAT(/,"+DSLINE NUMBER = ? ") 
DO 115 I=1,5 
115 CRTNM(1)=%20040L 
READ(5,#)CRTBYTE 


120 WRITE(6,122) 

122 FORMAT("+SPECIFY NEW FILE NAME = ? ") 
DO 123 I=1,3 

123 NAME(I)=%20040L 
READ(5,124) NAME 

124 FORMAT(3A2) 


eo Cc 
WRITE(6, 126) 
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126 FORMAT("4+SPECIFY FILE SECURITY CODE ", 
*" (DEFAULT = 0) = 2") 

READ(5, 130)SECURITY 

130 FORMAT(A2) 

C 

WRITE(6, 134) 

134 FORMAT("+SPECIFY CARTRIDGE NUMBER = 2") 
READ(5,201)CRTNM(1) 

201 FORMAT(A2) 





C 
C PREPARE TO DCRET 
c 

TYPE = 4 
c 

SIZE(1)=%100L 
c 

CALL BCRET (DCB, IERR,NAME,SIZE,TYPE,SECURITY, 

*CRTNM) 


IF (.CC.) 1240,209,209 
209 IF (IERR) 1260,300,300 
C 
C OPEN TERMINAL AS FILE 
C 
300 IFN=FOPEN(FORMALDES ) 
IF(.CC. )305,309,309 
305 CALL FCHECK(IFN, IERROR) 
WRITE (6,306) I ERROR 
306 FORMAT(" FOPEN $STDINX FAILED, CCL. ERROR = ",16) 
STOP 
C 
C FILE NOW CREATED 
C 
309 LENGTH = 36 
310 WRITE(6,312) 
312 FORMAT(" WRITE COMMANDS, TERMINATE WITH “ 
#" STOP’ are a 
Cc 
C LOOP 
C 
400 DO 410 I=1,36 
410 BUFFER(I)=%20040L 


: USE FREAD TO ALLOW ’:’ AND ’,’ 
: ICNT=FREAD (IFN, BUFFER, 36) 
IF(.CC.) 1050,420,600 
: TEST FOR ’??” 
oe IF (BUFINTG(1).EQ.%37477) GO TO 1100 
TEST FOR ’STOP’ 


IF ((BUFINTG(1).£Q.%51524) . AND. (BUFINTG(2) 
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#.EQ.%47520)) GO TO 600 





c 
{7 (DCB, IERR, BUFFER, ICNT) 
IF(.CC.) 1020,430, 430 
C 
430 IF (IERR) 1000,400,400 
C 
C END OF LOOP 
C 


600 WRITE(6,606) 
606 FORMAT(" BEGIN VERIFICATION:") 





CLO§(DcB, IERR) 
IF(.CC.) 1300,620,620 
620 IF(IERR) 1200,675,675 
C 
C C DCLOS COMPLETED. CLOSE TERMINAL. 
e Cc 
675 CALL FCLOSE(IFN,0,0) 
IF(.CC. )690, 700, 700 
C 
690 WRITE(6,692) 
692 FORMAT(" FCLOSE FAILED, CCL") 
STOP 


READ, VERIFY, AND TRUNCATE FILE 
OPEN OPTN=2 TO ALLOW TRUNCATION 


gOaOa 0 


700 OPTN=2 
CALL BS 
#CRTNM) 
IF(.CC.) 1340,705,705 
705 IF (IERR)1360,1370,730 
C 
730 WRITE(6,732)IERR 
732 FORMAT(" FILE TYPE = ",16) 
C 
C VERIFY LOOP 
C 





N(DCB, IERR, NAME, OPTN, SECURITY, 








ISIZE=36 
740 DO 742 I=1,40 
742 BUFFER(I)=%20040L 
C 
750 





C 
755 IF(ISIZE.EQ.0) GO TO 800 
IF (IERR.EQ.-12) GO TO 800 
IF (IERR) 1220, 760, 760 


760 BUFPRNT(1)=%20040L 
DO 758 I=1,39 
758 BUFPRNT(I+1)=BUFFER(I) 
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WRITE (6, 762) BUF PRNT 
762 FORMAT (40A2) 
Cc 





GO TO 740 
C 
C END VERIFY LOOP 
C 
C ENCOUNTERED END OF FILE 


=( DCB, IERR, RECNM, BLOCKNUM) 
IF(. CC. ) 1320, 802, 802 
802 IF (IERR)1330,803,803 





803 TRUNCATE=64-(BLOCKNUM+1) 
108 ( DCB, IERR, TRUNCATE) 

IF(.CC.) 1300, 805, 805 
805 IF(IERR) 1200, 820, 820 
c on 
820 WRITE(6,822) a 
822 FORMAT(" PROGRAM COMPLETED") 

STOP 





C 
C *## ERROR CONDITIONS ### 
Cc 
C DWRIT ERRORS 
C 
1000 WRITE(6,1002)IERR “~_ 
1002 FORMAT(" DWRIT ERROR, IERR = ",I6) 
GO TO 600 
Cc 
1020 WRITE(6,1022)IERR 
1022 FORMAT(" CCL ON DWRIT, IERR = ",I6) 





STOP 
C 
1050 CALL FCHECK(IFN, IERR) 
WRITE(6,1052)IERR 
1052 FORMAT(" BAD READ FROM TERMINAL, IERR = ", 
*I6) 
GO TO 310 
C 
C 


1100 WRITE(6,1110) 
1110 FORMAT(" GO TO ?? PART ") 
WRITE (6, 1120) 
1120 FORMAT(" THIS PROGRAM CREATES A FILE ", 
#"ON THE RTE.") 
WRITE (6, 1130) 
1130 FORMAT(" IT WRITES THE COMMANDS, THEN", 
#" CLOSES THE FILE.") 
GO TO 310 
C 
C 
1200 WRITE(6, 1202) IERR 
1202 FORMAT(" DCLOS ERROR, IERR = ",I6) 
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1330 
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1370 
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1380 
1382 
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STOP 


WRITE(6,1222)IERR 
FORMAT(" DREAD ERROR, IERR = “,1I6) 
STOP 


WRITE (6, 1242) IERR 
FORMAT(" CCL ON DCRET, IERR = ",1I6) 
STOP 


IF(IERR.EQ.-2) GO TO 1400 
WRITE(6,1262) ERR 

FORMAT(" DCRET ERROR, IERR = “,16) 
STOP 


WRITE(6,1272)IERR 
FORMAT(" CCL ON DPURG, IERR 
STOP 


" 16) 


WRITE(6, 1292) IERR 
FORMAT(" DPURG ERROR, IERR = ",I6) 
STOP 


WRITE(6,1302)IERR 
FORMAT(" CCL ON DCLOS, IERR 
STOP 


TI 


ao ,16) 


WRITE(6,1322)IERR 
FORMAT(" CCL ON DLOCF, IERR = ",I6) 
STOP 


WRITE(6,1332)IERR 
FORMAT(" DLOCF ERROR, IERR = ",I6) 
STOP 


WRITE (6, 1342) IERR 
FORMAT(" CCL ON DOPEN, IERR 
STOP 


" 16) 


WRITE (6, 1362) IERR 
FORMAT(" DOPEN ERROR, IERR = ",16) 
STOP 


WRITE(6, 1372) 
FORMAT(" FAILED TO DOPEN FILE, IERR = 0") 
STOP 


WRITE (6,1382)IERR 
FORMAT(" CCL ON DREAD, IERR = ",I6) 
STOP 


C DUPLICATE FILE NAME IN DCRET 


Cc 


1400 


WRITE(6, 1402) 
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1402 FORMAT("+DUPLICATE FILE NAME, WISH TO ", 
#" PURGE (Y/N) = 2") : 
READ(5,#)ANSW(1) "s 
IF (ANSW(1).EQ."N") GO TO 120 
IF (ANSW(1).EQ."Y") GO TO 1410 














GO TO 1400 
c 
1410 CALL DPURG (DCB, IERR, NAME, SECURITY, CRTNM) 
IF (.CC.) 1270, 1412, 1412 
c 


1412 IF(IERR) 1280, 1420, 1420 







BCRET(DCB, IERR, NAME, SIZE, TYPE, 
*SECURITY, CRTNM) 
IF(.CC.) 1240, 1430, 1430 





Cc 
1430 IF(IERR) 1260,300,300 
C 





END a7 











5-30 

















SECTION 


PROGRAM-TO-PROGRAM 


COMMUNICATIONS 





oo 





The preceding chapters describe how to establish communications links between HP 3000 and HP 1000 
computers in order to form a communications network, and how to execute programs in any HP 3000 or 
HP 1000 from a single log-on terminal. Furthermore, the programs running within any HP 3000 or 
HP 1000 in the DS network can, under the proper circumstances, access the hardware or software 
resources available at either end. 


However, for most remote processing applications it is essential that separate user programs be able to run 
simultaneously in separate computers within the network, and also be able to communicate efficiently 
with one another. The DS/3000 program-to-program (PTOP) intrinsics described in this chapter provide 
that capability. 


The structure of the two programs that are communicating with one another in this manner is not 
symmetrical. One of them, referred to as the master program, is always in control and is the one that 
initiates all activity between the two programs. The other, referred to as the slave program, is always 
responding to requests received from the master. Those intrinsics used within a master program are 
summarized in Table 6-1 and those used within a slave program are summarized in Table 6-2. 


The master program can reside on either the HP 3000 or HP 1000; the program residing on the system 
opposite of the master is called the slave. The program, either slave or master, residing on the HP 3000 
system can be written in SPL, FORTRAN, COBOL, BASIC, PASCAL, or COBOL/II. The program, slave or 
master, residing on the HP 1000 system can be written in FORTRAN, PASCAL or assembly language. 
The calling sequences of HP 1000 programs are described in the DS/1000-IV User's Manual. 


Table 6-1. Master Program-to-Program Intrinsics 


HP 1000 HP 3000 FUNCTION 


POPEN Initiates and activates a slave process in a remote system using a 
specified remote program file. 


PREAD Sends a request to the remote slave program asking the slave to 
send a block of data back to the master. 


PWRITE Sends a block of data to the remote slave program. 
PCONTROL Transmits a tag field containing user-defined control information 
to the remote slave program and receives a tag field back from 


the slave. 


PCLOSE Terminates the remote slave process. 


PCHECK Returns an integer code specifying the completion status of the 
most recently executed master program-to-program intrinsic. 





Program~To-Program Communications 


The master program-to-program intrinsics are very similar to the MPE process handling and file system 
intrinsics that are used for process-to-process communication within a single-system environment. 


Table 6-2. Slave Program-to-Program Intrinsics 


HP 1000 HP 3000 FUNCTION 


GET Receives the next request from the master program. 


ACCEPT Accepts and completes the request received by the preceding GET 
intrinsic call. 


REJECT Rejects the request received by the preceding GET intrinsic call. 


PCHECK Returns an integer code specifying the completion status of the 
most recently executed slave program-to-program intrinsic. 


Terminates communication with a master program but resources 
are not released. The only released resources are those allocated 
by DS/1000-IV software. The ID segment for the slave will still 
exist. 





NOTE 


PCHECK is not required on the HP 1000 because there is an error parameter 
for each HP 1000 PTOP call. 


The HP 1000 program-to-program calls perform the same functions as their HP 3000 counterparts, but 
may have slightly different names for parameters. Refer to the DS/1000-IV User's Manual for details. 


Once a DS communications link exists between an HP 3000 and HP 1000, a user program (the master 
program) can create and activate a slave program. The POPEN intrinsic performs this function in place of 
the standard MPE CREATE and ACTIVATE intrinsics. 


When the master and slave program are both executing, the master program can send data (PWRITE) or 
control information (PCONTROL) directly to the slave program. The master can also send a read request 
(PREAD), or control request (PCONTROL) to the slave program asking that the slave send data and/or 
control information back to the master. 


When the master program in a master/slave pair exists on the HP 1000, the master program must make a 
call to HELLO to establish an HP 3000 session before calling POPEN to an HP 3000 slave program. Refer 
to the DS/ 1000-I1V User's Manual for details. 


ie, 


eer 














Program-To-Program Communications 


Performance Considerations 


The communications system overhead for a PTOP transfer and an RFA transfer is comparable. However, 
when designing applications, PTOP solutions may provide greater throughput compared to RFA because of 
the ability to pack data into the buffer. The actual size of the PTOP transfer depends upon the buffer 
size library used in the HP 1000 system, along with the configured line size of the communications link as 
set by the DSCONTROL command. The three HP 1000 libraries allow data buffers of approximately 304, 
1072, and 4096 words. 


When an HP 3000 master communicates with an HP 1000 slave, the maximum total data buffer is either 


$12, 1024 or 4096 words, depending upon which HP 1000 library is used. When an HP 1000 master 
communicates with an HP 3000 slave, it can transfer up to 4096 words. 


PTOP Intrinsics 


In the following descriptions of program-to-program intrinsics, superscripts are used to describe the types 
of parameters and whether they must be passed by value. The default is by reference. The superscripts 
have the following meanings: 


SUPERSCRIPT MEANING 


BA byte array 
BP byte pointer 
D double 
DA double array 
DV double by value 
I integer 
IA integer array 
IV integer by value 
L logical 
LA logical array 
LV logical by value 
O-V option variable 
R real 
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ACCEPT 


Accepts and completes the requests received by the preceding GET intrinsic call and returns an optional 
tag field to the remote HP 1000 master program. 


Syntax 


IA IV 0-V 





The ACCEPT intrinsic accepts the request received by the most recent GET intrinsic call, completes the 
requested operation, and transmits an optional tag field back to the remote HP 1000 master program. 


In the case of a POPEN request, the ACCEPT call transmits an optional tag field, ITAG, to the remote 
HP 1000 master program. 


In the case of a PREAD request, the ACCEPT call transmits the specified number of words, TCOUNT, from 
TARGET to the remote HP 1000 master program and transmits an optional tag field, ITAG, to the remote 


HP 1000 master program. See Figure 6-1. 
NOTE 


You may want to refer to Figure 6-3 in conjunction with Figure 6-1. 
Figure 6-3 shows the GET activity with PREAD which would occur prior to 
the ACCEPT activity. 


In the case of a PWRIT request, the ACCEPT call moves the specified number of words, TCOUNT, from the 
DS buffer to TARGET and transmits an optional tag field, ITACG, to the remote HP 1000 master program. 


See Figure 6-2. 
NOTE 


You may want to refer to Figure 6-4 in conjunction with Figure 6-2. 
Figure 6-4 shows the GET activity with PWRIT which would occur prior to 
the ACCEPT activity. 


In the case of a PCONTROL request, the ACCEPT call transmits an optional tag field, ITAG, to the remote 
HP 1000 master program. 
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Figure 6-1. ACCEPT Activity for PREAD 
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Figure 6-2, ACCEPT Activity for PNHRIT 
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Parameters 


ITAG 


TARGET 


TCOUNT 


Error Conditions 
CCE 
CCG 


CCL 


Integer array (optional). A 20-word array used for transmitting a tag 
field. The format of the tag field is defined by the master and slave 
programs of the user. 


Integer array (optional). An array for transmitting or receiving blocks of 
data. 


For PREAD requests, this array contains the block of data to be transmitted 
to the remote HP 1000 master program. 


For PWRITE requests, this array receives the block of data from the DS 
buffer. 


For POPEN and PCONTROL requests, this array has no meaning and should be 
omitted. 


Integer by value (optional). An integer specifying the number of words (if 
positive) or bytes (if negative) to be transmitted or received. 


For PREAD requests, this parameter specifies how many words of data are to 
be transmitted from TARGET to the remote HP 1000 master program. 


For PWRITE requests, this parameter specifies how many words of data are 
to be moved from the DS buffer to TARGET. 


For POPEN and PCONTROL requests, this parameter has no meaning and 
should be omitted. 


Request completed successfully. 
Not returned. 


An error occurred. Issue a PCHECK intrinsic call to determine the DS/3000 
subsystem or MPE file system err code. 


























GET 


Slave callable. Receives the next request from the remote HP 1000 master program. 


Syntax 


I I 0-V 





The GET intrinsic receives the next request from the remote HP 1000 master program and accepts an 
optional tag field, available in ITAG. 


Functional Return 


When the GET intrinsic is executed, it returns to the HP 3000 slave program a number, ifun, specifying 
the type of request received from the remote HP 1000 master program: 


ifun Meaning 
0 A error occurred. This value is returned only when the condition code 


CCL is also returned. Issue a PCHECK intrinsic call with a DSNUM 
parameter of zero to determine what happened. 


1 POPEN request received. 
2 PREAD request received. 
3 PWRIT request received. 
4 PCONT request received. 
5 This value is returned only when the condition code CCG is returned. It 


indicates that a pending MPE File System I/O-without-wait request was 
completed instead of a DS remote I/O request. The parameter JONUMBER 
contains the file number associated with the completed I/O request. 


The GET intrinsic call implicitly issues an IOWAIT(O) intrinsic call. The parameter ifun value of 0 
indicates that an IOWAIT error occurred. An ifun value of 5 occurs only if you are executing MPE File 
System intrinsic calls without wait in your program and the implicit IOWAIT(O) call completes a pending 
File System I/O request instead of the expected DS remote I/O request. In this case you will have to issue 
another GET call after processing the completed File System I/O request in order to receive the expected 
DS remote I/O request. 


GET 


Parameters 


ITAG 


IL 


IONUMBER 


(HP 1000) 
MASTER 





Integer array (optional). A 20-word array used for receiving a tag field. 
The format of the tag field is defined by the master and slave programs of 
the user. 


Integer (optional). A word that has meaning only when a PREAD or PWRIT 
request is received from the remote HP 1000 master program. For a PREAD 
request, JL contains an integer specifying the number of words requested by 
the remote HP 1000 master program. For a PWRIT request, ZL contains an 
integer specifying the number of words transmitted from the remote 
HP 1000 master program to the DS buffer. See Figures 6-3 and 6-4. 


Integer (optional). A word that has meaning only when the condition code 
CCG and an ifun of 5 are returned. In this case, IONUMBER contains the 
MPE File System number associated with the completed I/O-without-wait 
request. The default is that no file number is returned. 
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Figure 6-3. GET Activity with PREAD 
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Figure 6-4, GET Activity with PAHRIT 





Error Conditions 
CCE Request received successfully. 


CCG The implicit IOWAIT(0) call issued by the GET intrinsic completed a pending 
MPE File System I/O-without-wait request instead of a DS remote I/O 
request. The parameter, JONUMBER, contains the file number associated 
with the completed file system request. 





CCL An error occurred. Issue a PCHECK intrinsic call to determine the DS/3000 
subsystem or MPE file system error code. 


NOTE 


You must not use IOWAIT(O) calls within a program containing DS GET 
calls. If you were to use an IOWAIT(O) call and it responded to a DS remote 
I/O request, your program would not be able to understand the information 
returned by the IOWAIT call. 





PCHECK 


Returns an integer code specifying the completion status of the most recently executed DS 
program-to-program intrinsic. The PCHECK intrinsic may be used in both the master and slave programs. 


Syntax 


I IV 


icode: = PCHECK (DSNUM); 





Functional Return 


When the PCHECK intrinsic is executed, it returns to the calling program a number, icode, that specifies 
the completion status of the most recently executed DS program-to-program intrinsic. The values of 
icode and the associated meanings are described in Appendix A. 


Parameters 


DSNUM Integer by value (required). In a master program, DSNUM is the link 
identifier returned by the particular POPEN intrinsic that initiated 
communications with the remote slave program. In a slave program, DSNUM 


is 0 (zero). 
Error Conditions 
CCE PCHECK request successfully completed. 
CCG Not returned. 
CCL PCHECK request denied because DSNUM was invalid. 


» 




















PCLOSE 


Master callable. Terminates program-to-program communciation with a remote HP 1000 slave program. 
The DS line remains open. 


Syntax 


IV 
PCLOSE (DSNUM) ; 





Parameters 


DSNUM Integer by value (required). The line number returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 


Error Conditions 


CCE Successful completion. 
CCG Not returned. 
CCL Request denied; an error occurred. Issue a PCHECK intrinsic call to 


determine the DS/3000 subsystem or MPE file system error code. 


NOTE 


Although a master program normally signals the slave program to 
terminate by generating a code in the tag field, PCLOSE can be used to 
terminate the slave program unconditionally. However, make certain the 
HP 1000 slave program is not communicating with other master programs, 
since PCLOSE turns off the slave to other master programs also. 
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PCONTROL 


Master callable. Exchanges tag fields with the remote HP 1000 slave program. 


Syntax 


IV IA 0-V 





The PCONTROL intrinsic optionally transmits a tag field to the remote HP 1000 slave program and accepts 
one in return. The remote HP 1000 slave program must issue a GET intrinsic call followed by either an 
ACEPT or REJCT call to complete the PCONTROL operation. Both the ACEPT and REJCT calls transmit a 
tag field back to the master program, available in ITAG. 


Although this intrinsic was designed specifically to exchange tag fields, you will notice that ITAG is an 
optional parameter. If the master program did not transmit a tag field, then the returned tag field, if any, 
is not accessible. 


The PCONTROL activity is described in Figure 6-5. 


Parameters 

DSNUM Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 

ITAG Integer array (optional). A 20-word array used for transmitting and 


receiving a tag field. The format of the tag field is defined by the master 
and slave programs of the user. 


Error Conditions 


CCE Request accepted by remote HP 1000 slave program. 
CCG Request rejected by remote HP 1000 slave program. 
CCL Request denied; an etror occurred. Issue a PCHECK intrinsic call to 


determine the DS/3000 subsystem or MPE file system error code. 
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Figure 6-5, PCONTROL Activity 





PCONTROL 


POPEN 


Master callable. Initiates program-to-program communication with a remote slave program. 


Syntax 


I BA BA IA BA IV IV 
dsnum: = POPEN (DSDEVICE ,PROGNAME [ |, PARAM] [FLAGS] 


Bf 


IV IV 0-V 


BH 
Cs 





The POPEN intrinsic activates a slave program in the remote HP 1000 having the specified program name, 
PROGNAME, and optionally transmits a tag field, ITAG, to that remote HP 1000 slave program. 


The remote HP 1000 slave program must issue a GET intrinsic call followed by either an ACEPT or REJCT 
call to complete the POPEN operation. 


The remote HP 1000 slave program may transmit a tag field back to the master program as part of an 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in ITAG. If the master program did not transmit a tag field, then the returned tag field, if any, 
is not accessible. 


The remote HP 1000 slave program remains activated and the communications link intact even if the 
POPEN request is rejected by the remote HP 1000 slave program. The meaning of a POPEN rejéct by the 
remote HP 1000 slave program must be established as part of the user application design. 


Functional Return 


When the POPEN intrinsic is executed, it returns to the master program a number, dsnum, by which DS 
uniquely identifies the particular communications link. The POPEN activity described below is illustrated 
in Figure 6-6. 


Parameters 

DSDEVICE Byte array (required). Contains a string of ASCII characters terminated by 
a space. This string must be the DS device class name, logical device 
number, or node name for DS/X.25 for the communications line you will 
be using to access the remote HP 1000. 

PROGNAME Byte array (required). Contains a string of up to five ASCII characters that 
names a remote HP 1000 slave program. 

ITAG Integer array (optional). A 20-word array used for transmitting and 


receiving tag fields. The format of the tag field is defined as part of the 
user application. Default: A tag field of all zeros is sent; the returned tag 
field, if any, is not available to the master program. 








ENTRYNAME 
PARAM 
FLAGS 
STACKSIZE 
DLSIZE 
MAXDATA 


BUFSIZE 


Error Conditions 
CCE 
CCG 


CCL 


POPEN 


These are all MPE parameters used to specify program loading. They are 
ignored when the slave system is an RTE system. The commas must be 
included however since these are positional parameters. 


Integer by value (optional). The size in words of the communications 
buffer (DS buffer) that is established by the remote DS software. Note that 
this parameter defines the maximum number of words of data that can be 
transmitted by a PWRITE or PREAD intrinsic call. In the default condition, 
this value is the same size as the line buffer defined by the DSLINE 
command (LINE8UF=) for the first DSLINE issued to the dsdevice. It will 
never be smaller than 304 words. If no LINEBUF= is specified by the first 
DSLINE command, then the default configuration length is used. Must be 
equal to 138 for X.25. This parameter must be specified for a buffer of 
342 words or greater. 


Request accepted by remote HP 1000 slave program. 
Request rejected by remote HP 1000 slave program. 


Request denied; an error occured. Issue a PCHECK intrinsic call to 
determine the DS/3000 subsystem or MPE file system error code. 


POPEN 


1) Schedule the remote slave program. 


(HP 3000) ; ; (HP 1000) 
MASTER 2) Send optional tag field. sae 





DS/3000 
BUFFER 





Send optional 
tag field. 





Figure 6-6. POPEN Activity 








PREAD 


Master callable. Asks the remote slave program to send a block of data. 


Syntax 


I IV IA IV IA 0-V 


lgth: = PREAD (DSNUM,TARGET ,TCOUNT[,ITAG]); 





The PREAD intrinsic transmits a read request to the remote HP 1000 slave program and optionally 
transmits a tag field from ITAG to the remote HP 1000 slave program. The remote HP 1000 slave 
program must issue a GET intrinsic call followed by either an ACEPT or REJCT call to complete the PREAD 
operation. 


The ACEPT call moves the requested block of data from the user’s buffer in the remote HP 1000 system to 
TARGET in the master program. 


The REJCT call transmits no data, other than an optional tag field. 


The remote HP 1000 slave program may transmit a tag field back to the master program as part of the 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in ITAG. If the master program did not transmit a tag field, then the returned tag field, if any, 
is not accessible. 


Functional Return 


When the PREAD intrinsic is executed, it returns to the master program a number, lgth, specifying how 
many words (if TCOUNT is positive) or bytes (if TCOUNT is negative) of data were actually received into 
TARGET. The PREAD activity is illustrated in Figure 6-7. 


Parameters 

DSNUM Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call that initiated communication with the remote slave 
program. 

TARGET Integer array (required). The array into which data received from the 
remote slave program will be deposited. 

TCOUNT Integer by value (required). The positive number of words of data or the 
negative number of bytes of data requested. Data buffer sizes can be up to 
$12, 1024, or 4096 depending on the buffer size library generated in to the 
HP 1000 system to which the DS line is opened. See the DS/1000-IV 
Network Manager's Manual for details. 

ITAG Integer array (optional). A 20-word array used for sending and receiving a 


tag field. The format of the tag field is defined by the master and slave 
programs of the user. 


PREAD 


Error Conditions 


D 


CCE Request accepted by the remote HP 1000 slave program. 
CCG Request rejected by the remote HP 1000 slave program. 
CCL Request denied; an error occurred. Issue a PCHECK intrinsic call to 


determine the DS/3000 subsystem or MPE file system error code. 


(HP 3000) (HP 1000) 
MASTER SLAVE 


Send read request and 
optional tag field. 


TARGET 


i ce . 
USER’S optional 
BUFFER tag field. CoRR 
ACEPT i 
> (Send data from user’s 3a, 
BUFFER 


REJCT 
(no data transmitted) 


= ~ 
‘o,~™~ buffer to remote master 
a T, program) 





Figure 6-7, PREAD Activity 
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PWRITE 


Master callable. Sends a block of data to the remote HP 1000 slave program. 


Syntax 


IV IA IV IA 0-V 





The PWRITE intrinsic transmits a block of data from TARGET, and optionally transmits a tag field, ITAG, 
to the remote HP 1000 slave program. The number of words or bytes to be transmitted is specified in 
TCOUNT. The maximum number of words that may be transferred is 4096. 


The remote slave program must issue a GET call prior to accepting or rejecting the PWRITE request. GET 
returns information to the slave program concerning the nature of the master request, such as the length 
of the PWRITE data. The HP 1000 slave program may optionally receive the PWRITE information with 
the call to GET or wait until calling ACEPT. The remote HP 1000 slave program must issue a GET call 
followed by either an ACEPT or REJCT call to complete the PWRITE operation. 


The remote HP 1000 slave program may transmit a tag field back to the master program as part of the 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in ITAG. If the master program did not transmit a tag field, then any returned tag field is not 
accessible. 


The PWRITE activity is illustrated in Figure 6-8. 


Parameters 

DSNUM Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 

TARGET Integer array (required). The array from which data is transmitted to the 
remote HP 1000 slave program. 

TCOUNT Integer by value (required). The positive number of words of data to be 
transmitted or the negative number of bytes. Data buffer sizes can be up 
to 512, 1024, or 4096 words depending on the buffer size library generated 
in to the HP 1000 that the DS line is open to. See the DS/1000-IV 
Network Manager's Manual for details. 

ITAG Integer array (optional). A twenty-word array used for sending and 


receiving a tag field. The format of the tag field is defined by the master 
and slave programs of the user. 


PWRITE 





Error Conditions 


CCE Request accepted by remote HP 1000 slave program. 
CCG Request rejected by remote HP 1000 slave program. 
CCL Request denied; an error occurred. Issue a PCHECK intrinsic call to 


determine the DS/3000 subsystem or MPE file system error code. 


(HP 3000) (HP 1000) 
MASTER (data) 





GET 
(data from master is USER’S 


moved to user buffer BUFFER 
or SAM) 


USER’S 
BUFFER 
ACEPT 


TARGET (if data is in SAM, 


MASTER Send optional its moved from SAM 
tag field. to user buffer here) 


PWRITE z ; 
Send write request, optional 


tag field, and data. 








REJCT 


(data is not passed to 
slave program} 





Figure 6-8, PWRITE Activity. 
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REJECT 


Rejects the request received by the most recent GET intrinsic call and returns an optional tag field back to 
the remote HP 1000 master program. 


Syntax 


IA 0-V 





Parameters 
ITAG Integer array (optional). A 20-word array used for transmitting a tag 


field. The format of the tag field is defined by the master and slave 
programs of the user. 


Error Conditions 


CCE Response transmitted successfully to the remote HP 1000 master program. 
CCG Not returned. 
CCL An error occurred. Issue a PCHECK intrinsic call to determine the DS/3000 


subsystem or MPE file system error code. 


NOTE 


See Figures 6-1 and 6-2 which appear in the discussion of ACCEPT. 
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PROGRAM EXAMPLES 


The following are examples of master program and slave program pairs. The examples include an 
HP 3000 master - HP 1000 slave pair and an HP 1000 master - HP 3000 slave pair. See the 
DS/1000-IV User's Manual for details on the HP 1000 PTOP calls. 


Example 1: HP 3000 Master — HP 1000 Slave 


Master am on the HP 3000 


This is a master program (JMAST) that runs on the HP 3000 and sends a buffer to a slave program on the 
HP 1000 where it is reversed and sent back. 


$CONTROL USLINIT 
BEGIN 
COMMENT 


THIS HP 3000 MASTER PROGRAM PROMPTS THE USER FOR A BUFFER 

BE SENT TO THE REMOTE HP 1000 SLAVE PROGRAM WHERE THE BUFFER 
TS REVERSED. THE HP 3000 THEN READS THE REVERSED BUFFER BACK 
AND PRINTS IT ON THE USER’S TERMINAL. ALL COMMUNICATION IS 
ACCOMPLISHED USING THE PTOP INTRINSICS. ; 


INTEGER DSNUM, ICODE, LGTH; 

BYTE ARRAY BUFFER(0:79) ; 

BYTE ARRAY DSLINE(0:7):="151 es 
BYTE ARRAY MSG(0:79); 

BYTE ARRAY PROGNAME(0:5):="JSLAV "'s 


ARRAY IBUF(#)=BUFFER; 
ARRAY MSGI(#)=MSG; 


INTEGER ARRAY ITAG(0:19); 


INTRINSIC READ,PRINT,ASCIT; 
INTRINSIC 





PROCEDURE ERRORPROC(CC) ; 
VALUE CC; 
INTEGER CC; 


BEGIN 
IF CC=-1 THEN 
BEGIN 
ICODE: = BCHECK 
MOVE MSG(0):=" "3 
MOVE MSG(1):=MSG(0), (79); 
MOVE MSG(0):="PTOP REQUEST FAILED. ERROR = “; 
ASCII (ICODE, 10,MSG(30)); 
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PRINT (MSGI , -33,0); 
END; 





IF CC=1 THEN 
BEGIN 
MOVE MSG:="REMOTE REJECTED REQUEST"; 
PRINT (MSGI ,-23,0); 
END; 


END; 
<<BEGIN MAIN CODE>> 
<<POPEN REMOTE HP 1000 SLAVE PROGRAM>> 


DSNUM: = 
IF < THEN 


o BEGIN 
ERRORPROC(-1); 


GO TO ENDIT; 
END 
ELSE IF > THEN 
BEGIN 
ERRORPROC (1) ; 
GO TO ENDIT; 
END 


ELSE 
( BEGIN 


MOVE MSG:="POPEN SUCCESSFUL"; 
PRINT (MSGI ,-16,0); 
END; 





EN (DSLINE , PROGNAME , ITAG) ; 


<<PROMPT USER FOR BUFFER>> 


MOVE MSG:="ENTER BUFFER FOR TEST’; 
PRINT(MSGI,-21,0); 
Cc LGTH: =READ(IBUF , 40); 


<<SEND BUFFER TO REMOTE>> 


ITAG(0) : =LGTH; 
UPWRITE (DSNUM, IBUF ,LGTH,ITAG) ; 





IF < THEN 
BEGIN , 
ERRORPROC(-1); 
GO TO ENDIT; 
END 
ELSE IF > THEN 
BEGIN 
ERRORPROC (1); 
GO TO ENDIT; 
END 


“ ELSE 
BEGIN 
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MOVE MSG:="PWRITE SUCCESSFUL"; 
PRINT(MSGI,-17,0); 
END; 
<<GET REVERSED BUFFER FROM REMOTE>> 






LGTH: =: PREAD 
IF < THEN 
BEGIN 

ERRORPROC(-1); 
GO TO ENDIT; 
END 
ELSE IF > THEN 
BEGIN 
ERRORPROC(1); 
GO TO ENDIT; 
END 
ELSE 
BEGIN 
MOVE MSG:="PREAD SUCCESSFUL"; 
PRINT(MSGI,-16,0); 
PRINT(IBUF,LGTH,O); 
END; 


(DSNUM, IBUF ,40,ITAG) ; 


<<SEND PCONTROL TO TELL SLAVE TO ABORT ITSELF>> 
ENDIT: 


OL (DSNUM, ITAG) ; 





END. 
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Slave Program on the HP 1000 


The following is the HP 1000 slave program that is associated with the HP 3000 master program, JMAST, 
previously illustrated. 











FTN7X 
PROGRAM JSLAV 
C 
C SLAVE. GET BUFFER, REVERSE IT, AND SEND BACK 
Cc 
INTEGER BUF (40) ,P(2),CLASS,TAG(20) , BUFR( 40) 
Cc 
CALL RMPAR(P) 
CLASS = P(1) 
Cc 
1 CALL |GET (CLASS, IER,IFUN,TAG,IL) 
GOTO (10,20,30,40) IFUN 
Cc 
C OPEN 
Cc 
10 CALL 
GOTO 
Cc 
o C READ 
* Cc os 
20 CALL F(TAG, IER, BUFR) 
GOTO 1 
Cc 
C WRITE 
Cc 
30 CALL | ACEPT(TAG,IER, BUF) 





REVERSE BUFFER 


aan 


DO 31 I = 1,TAG(1) 
J=TAG(1)-I+1 
BUFR (J) =BUF (1) 

31 CONTINUE 

GOTO 1 


CONTROL 


nan 


40 CALL | 
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Example 2: HP 1000 Master - HP 3000 Slave 


Master Program on the HP 1000 


This is a master program that runs on the HP 1000 and sends a buffer toa slave program on the HP 3000 
where it is reversed and sent back. 


QNQaAaAQ 


aQOaan DQANMAN ot oe) QO0O0O0 OMOQOaOaQa0a 


aQO 
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PROGRAM JMAST 


THIS PROGRAM PROMPTS FOR AN INPUT BUFFER ON THE HP 1000, SENDS 
THE BUFFER TO A SLAVE PROGRAM ON AN HP 3000 WHICH REVERSES THE 
ORDER AND SENDS IT BACK AT THE REQUEST OF THE 1000 MASTER. 


INTEGER P(5),SNAM(3) ,BUF (40) ,PCB(4) , TAG(20) ,AB(2) , BUF 1 (40) 
INTEGER LOGON(7) ,PRMT(6) 


EQUIVALENCE (REG, AB) 

SNAM = THE NAME OF THE HP 3000 SLAVE PROGRAM 

LOGON = THE CHARACTER STRING FOR INITIATING A LOGON REQUEST 
TO THE HP 3000 OPERATING SYSTEM 

PRMT = THE PROMPT ON THE HP 1000 TO INPUT THE BUFFER TO BE 


REVERSED 


DATA SNAM/6HJSLAV /,LOGON/14HHELLO RON.DS / 
DATA PRMT/12HINPUT BUFFER/ 


INITIATE A SESSION ON THE HP 3000 WITH A CALL TO HELLO 
THE LINK LU OF THE HP 3000 IN THIS CASE IS LU 94 


CALL HELLO (IERR,94,1,NMSMP,LOGON, 14) 
SCHEDULE THE SLAVE PROGRAM ON THE HP 3000 
CALL 


IF (IER .LT. 0) WRITE (1,7) IER,1 
FORMAT ("| IERR= ",14," CALL TYPE: ",12) 





PROMPT FOR THE BUFFER TO BE REVERSED 
40 CHARACTERS MAXIMUM 


REG = DEXEC(-1,1, 1+4400B, BUF , 40, PRMT,6) 


SEND THE BUFFER TO THE HP 3000 SLAVE PROGRAM 
THE LENGTH OF THE BUFFER IS IN THE FIRST WORD OF TAG 


TAG(1) = AB(2) 
CALL F (PCB, IER,BUF,AB(2) , TAG) 





READ THE REVERSED BUFFER BACK FROM THE HP 3000 SLAVE 














Oona © aa 0 


aaanD 
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LENGTH OF THE BUFFER IS 40 CHARACTERS 


IL = 4 
CALL | PREAD (PCB,IER,BUF1,IL,TAG) 
IF (IER .LT. 0) WRITE (1,7) IER,2 








PRINT THE RETURNED BUFFER 


WRITE (1,9) BUF1 
FORMAT("“BUFFER IS ",/,40A2) 


CALL PCONT TO TELL THE SLAVE PROGRAM YOU ARE DONE 


CALL 





CALL BYE TO LOG OFF THE CREATED HP 3000 SESSION ESTABLISHED 
IN THE CALL TO HELLO 


CALL BYE (IERR,94,1,NMSMP) 
END 
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Slave Program on the HP 3000 


The following is the HP 3000 slave program that is associated with the HP 1000 master program, JMAST, 


previously illustrated. 


$CONTROL USLINIT 


Cc 
C 
C 


aOaan 
—_ 


MOaaANgaNAaAY 


aOnaa nm 


OOO 


20 


21 


QOaoan 
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PROGRAM JSLAV 
DECLARE THE PTOP SUBROUTINE CALLS AS SYSTEM INTRINSICS. 


SYSTEM INTRINSIC | CT 
INTEGER BUF (40) ,P(2) CLASS, TAG(20) , BUFR( 40) 





INVOKE THE GET FUNCTION TO WAIT FOR MESSAGES FROM THE 
MASTER PROGRAM ON THE HP 1000 





(TAG, IL, IONUMB) 





BRANCH TO THE APPROPRIATE PIECE OF SLAVE CODE TO HANDLE THE 
FUNCTION CODE RETURNED FROM THE GET 


FUNCTION CODES ARE: 
1 = POPEN, 2 = PREAD, 3 = PWRIT, 4 = PCONT, 5 = NO WAIT I/0 


GOTO (10,20,30,40,50) , IFUN 


POPEN CALL...CALL ACCEPT TO MASTER 
AND PERFORM ERROR CHECKING 


CALL 






IER 
WRITE 
GOTO 1 


PREAD CALL..CALL ACCEPT TO RETURN REVERSED BUFFER AND DO 
ERROR CHECKING 





| aK ( 
WRITE (6,1000) IER,2 
GOTO 1 


PWRITE CALL..CALL ACCEPT TO RETRIEVE BUFFER TO BE REVERSED AND 
DO ERROR CHECKING 





WRITE a oN IER,3 





PROGRAM EXAMPLES 





REVERSE RETRIEVED BUFFER IN DO LOOP 


aaa 


33 DO 32 1 = 1,TAG(1) 
J = TAG(1) - I +1 
BUFR(J) = BUF(I) 
32 CONTINUE 





GOTO 1 
Cc 
C PCONTROL CALL..CALL ACCEPT AND STOP PROGRAM 
Cc 
40 CALL 
STOP 
Cc 
Cc NO WAIT I/O CALL ENCOUNTERED AT GET FUNCTION 
C DISPLAY ERROR INFORMATION AND RETURN TO GET FUNCTION 
C 


50 DISPLAY "GET DONE ON NO WAIT I/0, WHICH IS NOT A " 
DISPLAY "DS FUNCTION. RETURN TO GET * 
DISPLAY “FILENUMBER = ",IONUMB 

1000 FORMAT ("PTOP ERROR. IERR = ",15," CALL TYPE: ",12) 
GOTO 1 
END 














6-29 


6-30 


( 3 








APPENDIX 


ERROR CODES AND MESSAGES 





>H 





The following is a summary of the messages that may be encountered together with their meanings. The 
messages, as listed here, have been grouped according to their associated activities. For this reason, some 
messages are listed under more than one heading. 


Communications link errors may appear while using the :DSLINE command, Remote File Access (RFA), or 
program-to-program intrinsics. The method of reporting depends on the operation in progress when an 
error Occurs. 


If you are performing remote FMP access, the error is returned in the error parameter. 


If you are using DEXEC calls, the error is returned as a four character ASCII code in the A and B 
registers. 





If you are using program-to-program operations, the error code is returned by the PCHECK intrinsic. 











DS/3000 SUBSYSTEM 


-DSLINE Syntax Errors 


These messages are sent to the terminal user to point out an error in syntax or to warn of the 
consequences of a request. 


1300 


1301 


1302 


1303 


1304 


1305 


1306 


1307 


1308 


1308 


1310 


1311 


1312 


1313 


1314 


1315 


1316 


1317 


1318 


1319 


1320 


1321 


1322 


REMOTE JOBS ARE NOT ALLOWED !. (CIERR 1300) 

DSLINE CANNOT CONTAIN BOTH OPEN AND CLOSE. (CIERR 1301) 

DSLINE REQUIRES AT LEAST ONE PARAMETER. (CIERR 1302) 

DSNUMBER SPECIFICATION MUST BE A NUMBER FROM 1 THRU 255. (CIERR 1303) 
DSLINE #1! DOES NOT IDENTIFY AN OPEN DS LINE. (CIERR 1304) 


EXPECTED LINEBUF, PHNUM, IOCID, REMID, OPEN, CLOSE, QUIET, COMP, NOCOMP, 
OR EXCLUSIVE. (CIERR 1305) 


MULTIPLE USE OF ! IS NOT ALLOWED. (CIERR 1306) 

THE SYNTAX FOR £ REQUIRES AN = SIGN FOLLOWED BY DATA. (CIERR 1307) 
PHNUM IS 1 TO 20 DIGITS AND DASHES. (CIERR 1308) 

t LIST CAN CONTAIN ONLY ONE ELEMENT. (CIERR 1309) 

THE SPECIFIED LOGICAL DEVICE IS NOT OPEN. (CIERR 1310) 

THE FIRST CHARACTER OF AN ID SEQUENCE MUST BE A " OR A ( (CIERR 1311) 
THE ID SEQUENCE MUST TERMINATE WITH A ). (CIERR 1312) 

THE ID SEQUENCE MUST TERMINATE WITH A“. (CIERR 1313) 

A NUMERIC ID SEQUENCE ELEMENT MUST BE 1 THRU 255 (OR 4377). (CIERR 1314) 
LINEBUF MUST BE A NUMERIC VALUE FROM 304 THRU 4096. (CIERR 1315) 
UNABLE TO COMPLETE THE REMOTE COMMAND. (CIERR 1316) 

NOT A CURRENTLY AVAILABLE DSLINE. (CIERR 1317) 

USE OF EXCLUSIVE REQUIRES BOTH NS AND CS CAPABILITY. (CIERR 1318) 


THE DS LINE #L! IS IN USE BY A PROGRAM OR SUBSYSTEM AND CANNOT BE CLOSED. 
(CIERR 1319) 


EXPECTED A RESPONSE OF YES, Y, NO, OR N. (CIERR 1320) 
UNABLE TO OPEN THE DS LINE ON DEVICE $. (CIERR 1321) 


@ IS INVALID IN THIS CONTEXT. (CIERR 1322) 


























1323 


1324 


1325 


1326 


1389 


1390 


1391 


1392 


1393 


1394 


1395 


1396 


1397 


1398 


1399 


DS/3000 SUBSYSTEM 
A DSLINE OPEN REQUIRES A VALID DS DEVICE NAME AS THE FIRST PARAMETER. 
(CIERR 1323) 
FROM ADDRESS MUST BE BETWEEN 1 AND 14 CHARACTERS INCLUSIVE. (CIERR 1324) 
TO ADDRESS MUST BE BETWEEN 1 AND 14 CHARACTERS INCLUSIVE. (CIERR 1325) 
FROM AND TO ADDRESS MUST BE A DECIMAL NUMBER. (CIERR 1326) 
INVALID OR MISSING DELIMITER FOR SELECTION SIGNAL SEQUENCE. (CIERR 1389) 
SELECTION SIGNAL SEQUENCE MUST BE FROM 1 TO 30 CHARACTERS. (CIERR 1390) 
BOTH QUEUE AND NONQUEUE SPECIFIED; NONQUEUE USED. (CIWARN 1390) 
ONLY ! WORDS WERE ALLOCATED FOR THE LINE BUFFER. (CIWARN 1392) 


COMPRESSION REQUEST NOT HONORED. REMOTE DOES NOT SUPPORT THIS FEATURE. 
(CIWARN 1393) 


COMPRESSION PARAMETER RESPECIFIES AND OVERRIDES PREVIOUS COMPRESSION 
PARAMETER. (CIWARN 1394) 


OPEN PARAMETERS ENTERED ON A CLOSE REQUEST ARE IGNORED (CIERR 1395) 
AN ID LIST MUST CONTAIN 255 OR LESS ELEMENTS. (CIWARN 1396) 

AN UNNECESSARY DELIMITER IS IGNORED. (CIWARN 1397) 

THERE ARE NO DS LINES OPEN. (CIWARN 1398) 


MULTIPLE USE OF ! IS REDUNDANT AND IGNORED. (CIWARN 1399) 


DS/3000 Functional Errors 


These messages report a functional problem within the system. 


201 


202 


203 


204 


205 


206 


207 


REMOTE DID NOT RESPOND WITH THE CORRECT REMOTE ID. (DSERR 201) 
SPECIFIED PHONE NUMBER IS INVALID. (DSERR 202) 


REMOTE ABORT/RESUME NOT VALID WHEN DOING PROGRAM-TO-PROGRAM COMMUNICATION. 
USE LOCAL ABORT/RESUME. (DSWARN 203) 


UNABLE TO ALLOCATE AN EXTRA DATA SEGMENT FOR DS/3000. (DSERR 204) 
UNABLE TO EXPAND THE DS/3000 EXTRA DATA SEGMENT. (DSERR 205) 
SLAVE PTOP FUNCTION ISSUED FROM A MASTER PROGRAM. (DSERR 206) 


SLAVE PTOP FUNCTION OUT OF SEQUENCE. (DSERR 207) 


DS/3000 SUBSYSTEM 


208 MASTER PTOP FUNCTION ISSUED BY A SLAVE PROGRAM. (DSERR 208) 





209 SLAVE PROGRAM DOES NOT EXIST OR IS NOT PROGRAM FILE. (DSERR 209) 
Creation of Slave Program failed, possibly due to invalid stack size. 


210 WARNING -- INVALID MAXDATA OR DLSIZE FOR A SLAVE PROGRAM. SYSTEM DEFAULTS 
ARE IN EFFECT. (DSWARN 210) 


211 SLAVE ISSUED A REJECT TO A MASTER PTOP OPERATION. (DSWARN 211) 
212 FILE NUMBER FROM IOWAIT NOT A DS LINE NUMBER. (DSWARN 212) 
213 EXCLUSIVE USE OF A DS LINE REQUIRES BOTH ND AND CS CAPABILITY. (DSERR 213) 


214 THE REQUESTED DS LINE HAS NOT BEEN OPEN WITH A USER :DSLINE COMMAND OR A 
REQUIRED :REMOTE HELLO HAS NOT BEEN DONE. (DSERR 214) 


215 DSLINE CANNOT BE ISSUED BACK TO THE MASTER COMPUTER. (DSERR 215) - 
216 MESSAGE REJECTED BY THE REMOTE COMPUTER. (DSERR 216) ie 
217 INSUFFICIENT AMOUNT OF USER STACK AVAILABLE. (DSERR 217) 

218 INVALID PTOP FUNCTION REQUESTED. (DSERR 218) 


219 MULTIPLE POPEN. ONLY ONE MASTER PTOP OPERATION CAN BE ACTIVE ON A DS LINE. 
(DSERR 219) 


220 PROGRAM EXECUTING GET WAS NOT CREATED BY POPEN. (DSERR 220) 
221 INVALID DS MESSAGE FORMAT. INTERNAL DS ERROR. (DSERR 221) 

222 MASTER PTOP FUNCTION ISSUED PRIOR TO A POPEN. (DSERR 222) 

223 REQUEST TO SEND MORE DATA THAN SPECIFIED IN POPEN. (DSERR 223) 


224 FILE EQUATIONS FOR A REMOTE FILE CONSTITUTE A LOOP. (DSERR 224) 





225 CANNOT ISSUE POPEN TO A SLAVE SESSION IN BREAK MODE. (DSERR 225) 
226 “SLAVE PROGRAM HAS TERMINATED BEFORE EXECUTING "GET". (DSERR 226) 
227 REMOTE HELLO MUST BE DONE TO INITIATE REMOTE SESSION. DSERR 227) 
228 EXCEEDED MAXIMUM NUMBER OF VIRTUAL CHANNELS PER JOB. (DSERR 228) 


229 TOO MANY DS USERS ON THIS SYSTEM. CANNOT OBTAIN A VIRTUAL PROCESS NUMBER. 
(DSERR 229) 


231 INVALID FACILITY IN CONNECTION REQUEST. (DSERR 231) 


232 THE REMOTE COMPUTER IS NOT OBTAINABLE. (DSERR 232) 





233 VIRTUAL CIRCUIT IS NOT OBTAINABLE. (DSERR 233) 














234 


235 


236 


237 


238 


239 


240 


241 


242 


243 


244 


245 


246 


247 


248 


249 


250 


251 


252 


253 


254 


255 


256 


DS/3000 SUBSYSTEM 


QUEUEING IS REQUIRED TO COMPLETE THE REQUEST. (DSERR 234) 

DS MESSAGE SEQUENCING ERROR. (DSERR 235) 

COMMUNICATIONS HARDWARE HAS DETECTED AN ERROR. (DSERR 236) 
CANNOT CURRENTLY GAIN ACCESS TO THE TRACE FILE. (DSERR 237) 
COMMUNICATIONS INTERFACE ERROR. INTERNAL FAILURE. (DSERR 238) 
COMMUNICATIONS INTERFACE ERROR. TRACE MALFUNCTION. (DSERR 239) 
LOCAL COMMUNICATION LINE WAS NOT OPENED BY OPERATOR. (DSERR 240) 
DS LINE IN USE EXCLUSIVELY OR BY ANOTHER SUBSYSTEM. (DSERR 241) 
INTERNAL DS SOFTWARE ERROR ENCOUNTERED. (DSERR 242) 

THE REMOTE COMPUTER IS NOT RESPONDING. (DSERR 243) 


COMMUNICATIONS INTERFACE ERROR. THE REMOTE COMPUTER RESET THE LINE. 
(DSERR 244) 


COMMUNICATIONS INTERFACE ERROR. RECEIVE TIMEOUT. (DSERR 245) 
COMMUNICATIONS INTERFACE ERROR. REMOTE DISCONNECTED. (DSERR 246) 
COMMUNICATIONS INTERFACE ERROR. LOCAL TIME OUT. (DSERR 247) 
COMMUNICATIONS INTERFACE ERROR. CONNECT TIME OUT. (DSERR 248) 
COMMUNICATIONS INTERFACE ERROR. REMOTE REJECTED CONNECTION. (DSERR 249) 
COMMUNICATIONS INTERFACE ERROR. CARRIER LOST. (DSERR 250) 


COMMUNICATIONS INTERFACE ERROR. LOCAL DATA SET FOR THE DS LINE WENT NOT 
READY. (DSERR 251) 


COMMUNICATIONS INTERFACE ERROR. HARDWARE FAILURE. (DSERR 252) 


COMMUNICATIONS INTERFACE ERROR. NEGATIVE RESPONSE TO THE DIAL REQUEST BY 
THE OPERATOR. (DSERR 253) 


COMMUNICATIONS INTERFACE ERROR. INVALID I/O CONFIGURATION. (DSERR 254) 
COMMUNICATIONS INTERFACE ERROR. UNANTICIPATED CONDITION. (DSERR 255) 


REQUEST QUEUED BEHIND PREVIOUS REQUEST. (DSERR 256) 
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-DSCONTROL Informatory Messages 


These messages convey status information. 


300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 


314 


DS DEVICE !: MASTER AND SLAVE ACCESS SHUT. 

DS DEVICE !: SLAVE ACCESS OPENED; MASTER ACCESS SHUT. 
DS DEVICE !: MASTER ACCESS OPENED; SLAVE ACCESS SHUT. 
DS DEVICE !: MASTER AND SLAVE ACCESS OPENED. 

DS DEVICE $!: TRACE ACTIVATED USING TRACE FILE !. 

DS DEVICE !: TRACE DEACTIVATED. 

DS DEVICE !: MONITORING ACTIVATED. 

DS DEVICE !: MONITORING DEACTIVATED. 

DS DEVICE !: DEBUG MODE ACTIVATED. 

DS DEVICE !: DEBUG MODE DEACTIVATED. 

DS DEVICE !: SPECIAL DEBUG MODE ACTIVATED. 

DS DEVICE !: DEFAULT MODE IS NO COMPRESSION. 

DS DEVICE $: DEFAULT MODE IS COMPRESSION. 

DS DEVICE !: RETRY COUNT NOW EQUALS !. 


DS DEVICE !: CALL REQUEST CANCELLED. 


-DSCONTROL Error Messages 


These messages point out an error in syntax or warn of the consequences of a request. 


4100 


4101 


4102 


4103 


4104 


NUMBER OF PARAMETERS EXCEEDS MAXIMUM OF !. (CIERR 4100) 


EXPECTED AT LEAST TWO PARAMETERS: A DS DEVICE CLASS/NUMBER AND A FUNCTION 
KEYWORD. (CIERR 4101) 


EXPECTED A DEVICE CLASS NAME OR LOGICAL DEVICE NUMBER FOR ONE OR MORE DS 
DEVICES. (CIERR 4102) 


USER IS NOT ASSOCIATED WITH DS DEVICE $. NO CONTROL FUNCTIONS EXECUTED 
FOR THIS DEVICE. (CIWARN 4103) 


USER IS NOT ALLOWED TO USE :DSCONTROL AND IS NOT ASSOCIATED WITH THE DS 
DEVICE(S). (CIERR 4104) 

















4105 


4106 


4107 


4108 


4109 


4110 


4111 


4112 


4113 


4114 


4115 


4116 


4117 


4118 


4119 


4120 


4121 


4122 


4123 


4124 


4125 


4126 


4127 


4128 


4129 


DS/3000 SUBSYSTEM 
EXPECTED ONE OR MORE OF THE CONTROL FUNCTIONS: OPEN, SHUT, MON, MOFF, 
COMP, NOCOMP, TRACE, OR DEBUG. (CIERR 4105) 


INVALID CONTROL FUNCTION. EXPECTED ONE OF: OPEN, SHUT, MON, MOFF, COMP, 
NOCOMP, TRACE, OR DEBUG. (CIERR 4106) 


MASTER OVERRIDES PREVIOUS MASTER/SLAVE OPTION. (CIWARN 4107) 
SLAVE OVERRIDES PREVIOUS MASTER/SLAVE OPTION. (CIWARN 4108) 
SPEED OPTION OVERRIDES PREVIOUS SPEED OPTION. (CIWARN 4109) 
OPEN OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN 4110) 
SHUT OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN 4111) 
TRACE OVERRIDES PREVIOUS TRACE FUNCTION(S). (CIWARN 4112) 
DEBUG OVERRIDES PREVIOUS DEBUG FUNCTION(S). (CIWARN 4113) 
MON OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN 4114) 

MOFF OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN 4115) 
COMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. (CIWARN 4116) 
NOCOMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. (CIWARN 4117) 
EXPECTED A "3" , "," , OR RETURN AS DELIMITER. (CIERR 4118) 
EXPECTED EITHER A "3" OR RETURN AS DELIMITER. (CIERR 4119) 
EXPECTED A "=" AS DELIMITER FOR SPEED OPTION. (CIERR 4120) 
EXPECTED A "," AS DELIMITER BETWEEN OPTIONS. (CIERR 4121) 


ILLEGAL OPEN/SHUT OPTION. EXPECTED ONE OF: MASTER, SLAVE, SPEED, OR 
LINESPEED VALUE. (CIERR 4122) 


EXPECTED A POSITIVE DOUBLE VALUE FOR LINESPEED. (CIERR 4123) 

CS CAPABILITY REQUIRED TO USE :DSCONTROL. (CIERR 4124) 

PM CAPABILITY REQUIRED TO USE DEBUG FUNCTION. (CIERR 4125) 
DEBUG FUNCTION MAY ONLY BE USED BY SYSTEM CONSOLE. (CIERR 4126) 


EXPECTED NO OPTION FOR DEBUG OR ONE OF THE FOLLOWING: ON, OFF, OR POSITIVE 
INTEGER VALUE. (CIERR 4127) 


EXPECTED NO OPTION FOR MON/MOFF OR ONE OF THE FOLLOWING: CS OR DS. (CIERR 
4128) 


COMP/NOCOMP FUNCTIONS HAVE NO OPTIONS. (CIERR 4129) 
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4130 


4131 


4132 


4133 


4134 


4135 


4136 


4137 


4138 


4139 


4140 


4141 


4142 


4143 


4144 


4145 


4146 


4147 


4148 


4149 


4150 


4151 


4152 


4153 


4154 


SPEED OPTION IGNORED FOR SHUT FUNCTION. (CIWARN 4130) 

EXTRANEOUS ";" IGNORED. POSSIBLE MISSING FUNCTION? (CIWARN 4131) 
EXTRANEOUS "," IGNORED. POSSIBLE MISSING OPTION? (CIWARN 4132) 
CREATION OF DS MONITOR PROCESS FAILED. (CIERR 4133) 

PROGRAM FILE "DSMON.PUB.SYS" MISSING. (CIERR 4134) 

DS MONITOR UNABLE TO RUN AS A SYSTEM PROCESS. (CIERR 4135) 

CS DEVICE ! IS UNAVAILABLE FOR USE. (CIERR 4136) 

DS DEVICE MUST BE OPEN PRIOR TO USE. (CIERR 4137) 


USER SPECIFIED TRACE FILE NOT ALLOWED WHEN MORE THAN ONE DEVICE IN DEVICE 
CLASS. (CIERR 4138) 


DS DEVICE ! CURRENTLY CONTROLLED ELSEWHERE. (CIWARN 4139) 

DS DEVICE !: OPEN/SHUT NOT EXECUTED DUE TO ABOVE. (CIWARN 4140) 
DS DEVICE !: TRACE NOT EXECUTED DUE TO ABOVE. (CIWARN 4141) 

DS DEVICE !: MON/MOFF NOT EXECUTED DUE TO ABOVE. (CIWARN 4142) 

DS DEVICE !: COMP/NOCOMP NOT EXECUTED DUE TO ABOVE. (CIWARN 4143) 
DS DEVICE !: DEBUG NOT EXECUTED DUE TO ABOVE. (CIWARN 4144) 

NO DS DEVICES REMAINING TO BE CONTROLLED. (CIWARN 4145) 

RETRY OVERRIDES PREVIOUS RETRY FUNCTION. (CIWARN 4146) 

EXPECTED AN "=" AS DELIMITER FOR RETRY FUNCTION. (CIERR 4147) 


INVALID RETRY COUNT, MUST SPECIFY "DEFAULT" OR A NUMBER BETWEEN O AND 255 
INCLUSIVE. (CIERR 4148) 


DS DEVICE !: RETRY NOT EXECUTED DUE TO ABOVE. (CIWARN 4149) 
DS INTERNAL FIX NUMBERS DIFFER. (CIWARN 4150) 


INCOMPATIBLE OR MISSING NONCRITICAL DS MODULE: DSCOPY, DSTEST, DS2026, OR 
DS2026CN. (CIWARN 4151) 


CRITICAL DS MODULES ARE INCOMPATIBLE, NO CONTROL FUNCTIONS EXECUTED. 
(CIERR 4152) 


MISSING CRITICAL DS SOFTWARE, NO CONTROL FUNCTIONS EXECUTED. (CIERR 4153) 


TOO MANY DS USERS ON THIS SYSTEM. CANNOT OBTAIN A VIRTUAL PROCESS NUMBER. 
(CIERR 4154) 








4155 


4180 


4181 


4182 


4183 


DS/3000 SUBSYSTEM 


PROMPT OVERRIDES PREVIOUS PROMPT FUNCTION(S). (CIERR 4155) 

REDUNDANT SPECIFICATION OF CANCEL OPTION IGNORED. (CIWARN 4180) 
CANCEL OPTION HAS NO PARAMETERS. (CIERR 4181) 

DS DEVICE ! IS NOT AN X.21 DEVICE; CANCEL NOT EXECUTED. (CIWARN 4182) 


NO CALL REQUEST FOR DE DEVICE !. (CIWARN 4183) 


RFA ERRORS 


These error messages may returned in the JERR parameter if the condition code = CCE. 


Error 
Code 


No error. 


The disc is down. 


A file already exists with the specified 
name. 


An attempt was made to backspace a 
device or type 0 file that cannot be 
backspaced. 


An attempt was made to create a type 2 
file with too many records, or the record 
size was too large. 


An attempt was made to read or position a 
record not written; or, on update, to write 
an illegal record length. 


An attempt was made to access a cartridge 
or file that cannot be found, or that has no 
more room. 


An attempt was made to access a file with 
no security or the wrong code. 


An attempt was made to open a file that 
was already opened exclusively, or to open 
eight programs, or the cartridge containing 
the file is locked. 


An attempt was made to position a type 0 
file with DPOSN or to force a type 0 file to 
a type |. 


Required parameters were omitted from 
the call. 


An attempt was made to access an 
unopened DCB. 


An attempt was made to read, write, or 
position beyond the file boundries. 


None. 


Try again and then report it to the 
system manager of the facility. 


Repeat with a new name or purge the 
existing file. 


Check the device type. 


Check the size parameter. 


Check the position or size parameters. 


Check the file name or cartridge 
number. If there is no more room on 
the cartridge, try another or decrease 
the file size. 


Find out the correct code and use it 


or do not access the file. 


Use CL or DL to locate the lock. If 
the file is being packed, check to see 
if the spool is shut down. 


Check the file type. 


Enter the parameters. 


Use CREATE or OPEN to open DCB; 
check for errors. 


Check the record position parameters; 
the result depends on the file type 
and call. 

















RFA ERRORS 


Error 
Code Meaning Corrective Action 


The cartridge is locked. Initialize the cartridge if it is not 
currently initialized; otherwise keep 
trying. 


No more room in the file directory. Purge the files and pack the directory 
if possible, or try another cartridge. 


The file name does not conform to the Make corrections to the name. 
syntax rules. 


Wrong type of code supplied; an attempt Check the size and type parameters. 
was made to create or purge a type 0 file or 

to create a O-length file. 

An attempt was made to read, write, or Check the file parameters, from 
position a type 0 file that does not support FMGR check the name. 

the operation. 

The destination node does not have FMP. 


Bad FCODE. Internal RFAM error. 


Incorrect entry number in RFAM. DCB 
destroyed. 


There isn’t any internal table space in 
RFAM. 


Internal RFAM tables are invalid. 
Illegal record size. 
System table error. 


Illegal or missing parameters. 





RFA ERRORS 


These error messages may be returned in the JERR parameter if the condition code = CCL, otherwise the 
error code is a DS/3000 subsystem error or an MPE file system error. 


Error 

Code Meaning 
3 
h) 








Not enough parameters. 






Parameter address violation 
at the HP 3000. 





72 Invalid DS line. 

















DEXEC ERRORS 


If the condition code = CCG, these four-character ASCII codes are returned in a double word ABREG. 


Error 
Code 


Illegal record size. 

Illegal request. 

System table error. 

Illegal or missing parameters. 
Illegal or missing parameters. 
Illegal logical unit. 

Logical unit not assigned. 
Illegal user buffer. 


Call rejected by the driver. 


LU not available to user’s session. 


Missing parameter. 
Illegal parameter. 
Program cannot be scheduled. 


Program cannot be defined. 


There is no resolution in the DEXEC TIME call. 





DEXEC ERRORS 


If the condition code = CCL, then a double word ABREG may be one of these binary values, otherwise the 
error code is a DS/3000 subsystem error or an MPE file system error. 


Error Meaning 
Code 

3 

5 


Not enough parameters. 


Parameter address violation 
at the HP 3000. 


Invalid DS line. 





If condition code = CCE the DEXEC call completed satisfactorily. 











APPENDIX 


DSCONTROL CONSOLE COMMAND 








Before establishing a DS/3000 communications link, the console :DSCONTROL command must be used to 
OPEN a line so that it is available to DS/3000 users. The :DSCONTROL command allows you to enable or 
disable the DS/3000 subsystem on a specific communications link. 


For easy reference, this command is shown in the following format: 


e SYNTAX Shows the format of the command. 

e PARAMETERS Describes the variables in the command. 
e OPERATION Describes the command in detail. 

e EXAMPLES Shows the command in use. 








‘?DSCONTROL 


Syntax 


:DSCONTROL dsdevice [function [... funetion]] 





where the parameter, function, has the following meanings: 


3; SHUT 


> 


;OPEN | ,MASTER ee 
eee: | [sPEED=] speed | 


,ON [JALL] [mask] [Snumentries] (GWRAP] [| filename] \ | 


;MON »DS 
;MOFF |,CS 


sRETRY={ 


Parameters 


dsdevice 
OPEN 


SHUT 
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| 
om 
| 
| 


DEFAULT 
count 


Required parameter. The logical device number or the device class name 
of the DS/3000 communications device (IODSO or IODSX). On your 
system’s I/O configuration listing, the device is back referenced by a pound 
sign (#) to a previously defined INP, HSI, or SSLC. 


For bisync DS/3000 (IODSO), the DS subsystem is enabled but no activity 
is initiated on the communications link. For DS/X.25 (IODSX), the DS 
subsystem establishes a communications link with the PDN. Makes the 
line available for remote communication via the DS/3000 Subsystem. 


Initiates an orderly line shutdown. Refer to OPERATION for details 
about the line closing procedure. 








ce 








MASTER 


SLAVE 


linespeed 


TRACE ,ON 


ALL 


mask 


:DSCONTROL 


Limits DS/3000 line activity to outgoing requests only. No incoming 
sessions are allowed. 


Limits DS/3000 line activity to incoming requests only; no outgoing 
activity is allowed. 


Default: Both MASTER and SLAVE processing are allowed. 


Transmission rate in characters per second (Bit Rate/8). This parameter is 
effective only if your system configuration for the line selected 
SPEED CHANGEABLE. Specify linespeed if yours is a European 
installation with modems running at half speed, or if the line is hardwired 
and you want to override the configured default. It may be necessary to 
include this parameter if the length of cables used for HSI communications 
has been changed since the system was configured. 


HSI speed: 250 000 (cable lengths less than 1000 ft.) 


125 000 (cable lengths greater than 1000 ft.) 


INP or SSLC speed: 250, 300, 600, or 1200 

INP only speed: 2400 (RS232) or 7000 (direct connect on V. 35) 

The SPEED= keyword in the OPEN option may be omitted from a 
:DSCONTROL command. For example, the following two commands have 
exactly the same effect: 

:DSCONTROL 60;O0PEN,MASTER,SPEED=250000 

:DSCONTROL 60;OPEN,MASTER, 250000 

Remember, both ends of the line must operate at the same speed. 

Default: System configuration values. 

Activates the TRACE facility to provide a record of communications 
activities. Trace parameters are positional. The line must already be open, 
or the OPEN keyword must also be included (to open the line). 

Generates trace records for all line activity. 

Default: Records are written only for transmission errors. 

An octal number preceded by a percent sign (%nn). Used to select type of 
trace entries generated. Refer to Sections 3 and 4 in the DS/3000 


HP 3000 to HP 3000 Network Administrator Manual for an explanation 
of the mask bits. Default: %37 (all except PSTN). 


:DSCONTROL 


numentries 


Decimal integer for the maximum number of entries in a trace record, not 
greater than 248. 


Default: 24. (See OPERATION. ) 


NOTE 


The maximum number of trace entries for an INP is 40. If an error 
message is received indicating insufficient trace memory available on the 
INP, the user must reactivate tracing using the next lower integer multiple 
of eight as the value for numentries. 


WRAP 


filename 


TRACE, OF F 


MON »DS 
CS 


MOF F 
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Trace entries that overflow the trace record overlay the prior trace record 
entries. 


Default: Overflow entries are discarded. 


A name for the trace file. 
Default: DSTRCxxx.PUB.SYS (where xxx is the LDEV of the dsdevice). 


Deactivates the TRACE facility, so that no records are kept of DS/3000 
actions, states, and events. Also closes the trace file. 


Activates internal communication monitoring activity to give additional 
information on a subsequent cold dump of the system. The line must be 
open for the use of MON. 


MON Requests monitoring of all levels of activity. 


MON , DS Requests monitoring at the DS/3000_ level of internal 
software operation. 


MON ,CS Requests monitoring at the Communication System level of 
internal software operation. 


Default: No monitoring. 
Used only for system troubleshooting. 


Deactivates internal DS/3000 monitor records. Line must be open for the 
use of MOFF. 























-DSCONTROL 


RETRY={| DEFAULT Changes the communications error retry count to the specified value. The 
count retry counter controls the number of times the system attempts to send or 
receive a message across the communications link. 
DEFAULT Specifies a limit of 15 retries after a line error occurs. 


count Can be any value within the range of 0 to 255. 


Default: 15. 


Operation 


Unless : DSCONTROL is issued from the master console, this command requires the user to have CS and ND 
capability. In addition, all users except the console operator are granted access to :DSCONTROL only if 
they are ALLOWed to use the command and are ASSOCIATEd with the specified DS device. 


Only one DS/3000 communications device can be active (OPEN) on a controller at any given time. Once 
opened (with the :DSCONTROL command), a communications link can be shared by multiple DS/3000 
users. It cannot, however, be shared by users of other communications subsystems supported by your 
system (for example, MRJE). Thus, you must SHUT the DS/3000 communications device before the 
controller can be opened for use by another subsystem. 

Before issuing a : DSCONTROL command, use the :SHOWDEV command to check whether a communications 
link is already established. The LDEV for the INP, SSLC, or HSI port will be UNAVAILable if the 
communications link is in use by any subsystem; the LDEV for a DS/3000 communication device, driver 
IODSO or IODSX, will be AVAI Lable if it is currently OPEN for use by DS/3000 users. 


If a DS device class includes more than one DS device, the functions specified in the : DSCONTROL 
command apply to all devices in that class. 


If you include more than one function in a :DSCONTROL command, each function (with its subparameter 
list) must be separated by a semicolon. A function that duplicates or conflicts with a previous function 
overrides that function. Functions can appear in any order but are executed in the following order: 

1. OPEN/SHUT 

2. TRACE 

3. MON/MOFF 

The default name of the trace file is: 

DSTRCxxx. PUB.SYS 


where xxx is the logical device number of the dsdevice. 


If no trace file exists when you turn on the trace facility and you do not specify numentries, the system 
creates a file to hold 24 entries in each record. 
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When using the bisync protocol, the SHUT parameter initiates an orderly line closing procedure. If no 
sessions or applications are using the line when you shut it, line disconnection occurs immediately. If any i ' 
user (including applications) has the line open, the line remains connected until all sessions and mo 
applications CLOSE the line, or until those accessing the line terminate or are aborted. Once SHUT by the 
console operator, no new users may access the line until the operator reopens it. When using the X.25 
capability of DS/3000, the SHUT parameter disconnects the line immediately, even if there are current 


users on the line. 
NOTE 


Occasionally you may not be able to SHUT a standard (non-X. 25) DS line. 

This could happen, for example, if a DS user forgot to issue a 

:DSLINE wxx;CLOSE command but still has a local session. It could also 

happen if a remote session is "hung." In such a situation, you can "kill" all 

activity across the line by issuing an :ABORTIO xx (where xxx is the 

logical device number of the dsdevice). Following the use of the 

:ABORTIO xxx command, a second :DSCONTROL xxx;SHUT command will —< 
complete successfully. 
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Examples 
To open X.25 line number 55, thereby making it available for use by DS/3000 users, enter: 


:DSCONTROL 55;O0PEN 


To permit the local HP 3000 to process only master (outgoing) requests on DS line number 55, enter: 


:DSCONTROL 55;OPEN,MASTER 





To activate the CS Trace facility for DS line 55 (the line is already open), enter: 


:DSCONTROL 55;TRACE,ON,ALL 


To open X.25 line 55 and activate CS Trace with a maximum of 40 entries in a trace record, enter: 


:DSCONTROL 55;OPEN;TRACE,ON,,,40 





To open the line named REMSYS and enable internal monitoring, enter: 


:DSCONTROL REMSYS ;OPEN;MON 











OQ 

















APPENDIX 


seraaie 


This appendix provides a brief discussion on troubleshooting should a failure occur during HP 3000 to 
HP 1000 communications. Your primary source of information during the troubleshooting process will be 
the DS/1000-IV Network Manager's Manual, the DS/3000 HP 3000 to HP 3000 User/Programmer 
Reference Manual, and the DS/3000 HP 3000 to HP 3000 Network Administrator Manual. These three 
manuals contain discussions specific to the individual systems for tracing and troubleshooting. 


TROUBLESHOOTING 





In order to obtain meaningful troubleshooting information, both the sending and receiving ends must be 
traced. This allows you or an HP Systems Engineer (SE) to compare the message formats from both ends 
to ensure that the message was not altered during transmission of the message. The DS/3000 HP 3000 to 
HP 3000 Network Administrator Manual and the DS/1000-IV Network Manager's Manual contain 
diagrams of the message formats. 


HP 3000 TROUBLESHOOTING AND TRACING 


The DSLIST program is used to obtain a list of the software module version numbers for the DS/3000, 
X.25 Link, and CS modules installed on your system. This list is required for all troubleshooting activities 
and must accompany each Service Request (SR) that you submit to your HP Systems Engineer (SE). 


In order to obtain the list, you must have READ access to the DS/3000 program files in PUB.SYS. The 
command syntax is: 


:RUN DSLIST.PUB.SYS 


DSTEST is a systems verification test used to check both the system software and the physical link 
between the computer systems. This test is accomplished by transmitting sample messages across the line 
using Remote File Access (RFA) or PTOP. With DSTEST you can select the number of passes, the word 
pattern to be transmitted, the mode of transmission, and the block size. See the DS/3000 HP 3000 to 
HP 3000 User/Programmer Manual for a more detailed discussion of DSTEST. 


NOTE 


To perform DSTEST you must have established a link to a remote HP 1000 
system using the :DSLINE command. In addition, when using RFA, the 
Remote File Access Monitor (RFAM) must have been scheduled by DINIT, 
the DS initialization program on the HP 1000. When using PTOP, the 
PTOP communication slave monitor (PTOPM) must be running and the 
slave program, DSTES (DSTEST is the master on the 3000), must be RP’d. 


Troubleshooting 


The DSTEST program may be executed in two modes. To execute DSTEST in diagnostic mode, enter the 


following command: 


:RUN DSTEST.PUB.SYS,DIAG 


Then respond to the questions as follows: 


-RFA or PTOP? 


«REMOTE COMPUTER? 


-DSLINE? 


~1000 FILE NAME? 


-NUMBER OF PASSES? 


» PATTERN? 


~BLOCK SIZE? 


-CONTINUE(Y/N)? 


Enter RFA for Remote File Access when testing the HP 1000 link. PTOP 
capability is supported to the HP 1000 if the slave (DSTES) is loaded there 
and PTOPM, the HP 1000 program-to-program slave monitor, was 
scheduled by DINIT. 


Enter 1000 (this question is only asked for RFA). 


Enter the device class or logical device number of the DS line to be 
tested. 


Enter a file name of six or fewer characters, beginning with an alphabetic 
character. The file will be purged upon completion of DSTEST, assuming 
that the test was completed successfully (only asked for RFA). 


Enter the number of passes desired, up to a maximum of 32767. A zero 
or a carriage return causes a default value of one pass to be used. 


Enter an octal word to be transferred. The percent sign indicating octal 
(%) must be entered. An illegal input causes the message, INPUT ERROR, 
to be printed. Enter a correct value or a carriage return to indicate a 
default value, which is 4177777. 


Enter the desired block size of the transfer. For the HP 1000 the block 
size must be less than 512 words. If a value greater than 512 is entered, 
an error message is printed. 


Enter a Y to select another set of options, or N to terminate the test. 


A second mode available for DSTEST is called the default mode. To initiate DSTEST in the default mode, 


enter the following: 


:RUN DSTEST.PUB.SYS 


You will then be prompted to enter the DS line you wish to test. DSTEST will then be initiated using one 
pass of PTOP and a 512 word buffer of all 4177777’s. 


DSTEST Examples 


DSTEST for PTOP 


:DSLINE 141 


DS LINE NUMBER = #L3 
:RUN DSTEST.PUB.SYS,DIAG 























Troubleshooting 


HEWLETT PACKARD 32185B.52.00 DSTEST/3000 MON, NOV 4, 1985, 8:32 AM 
.RFA OR PTOP? PTOP 

.DSLINE? 141 

.NUMBER OF PASSES? 1 

PATTERN? %1 

.BLOCK SIZE? 128 

128 WORD PROG TO PROG WRITES DONE: 1 ,SECS: 2.130 ,AVE: 2.130 
-CONTINUE(Y/N)? N 


END OF PROGRAM 


DSTEST for RFA 


:DSLINE 141 
DS LINE NUMBER = #L3. 
:RUN DSTEST.PUB.SYS,DIAG 


HEWLETT PACKARD 32185B.52.00 DSTEST/3000 MON, NOV 4, 1985, 8:37 AM 
-RFA OR PTOP? RFA 

.REMOTE COMPUTER? 1000 

-DSLINE? 141 

.1000 FILE NAME? TEMPO! 

.NUMBER OF PASSES? 22 

PATTERN? %11 

.BLOCK SIZE? 256 

256 WORD REMOTE RECS WRITTEN/READ: 22 ,SECS: 42.012 ,AVE: 1.909 
-CONTINUE (Y/N)? N 





END OF PROGRAM 


TRACING FACILITY. The CS/3000 Trace Facility available on the HP 3000 provides a record of the 
line actions, CS states, and events that occur during DS/3000 operations between computer systems. 


This trace facility is invoked by the operator with a :DSCONTROL command when OPENing the 
communications line, or after the OPEN when the line is active. The CS/3000 Trace Facility will record 
the line activity for a particular communications line until either DS/3000 terminates or the operator 
issues a new :DSCONTROL command with the TRACE ,OFF parameter. 


See the DS/3000 HP 3000 to HP 3000 Network Administrator Manual for specific instructions to invoke 
the CS/3000 Trace Facility. 


TRACE FORMATTING. Once the line activity has been recorded using the CS/3000 Trace Facility, 
the data may be formatted for easier interpretation. There are two formatting programs for DS. They 
are CSDUMP and DSDUMP. 


Troubleshooting 


CSDUMP does some formatting and displays all trace file data in raw form. DSDUMP allows you to 
choose a subset of the trace file to be formatted, and will also analyze the chosen data. In addition, 
CSDUMP will display all of the bisynchronous line protocol, while DSDUMP only displays the DS 
protocol. 

See the DS/3000 HP 3000 to HP 3000 Network Administrator Manual for specifics to use CSDUMP and 
DSDUMP. 


HP 1000 TROUBLESHOOTING AND TRACING 


There are two utility programs which should be run at the HP 1000 end to record, format, and analyze 
traffic sent over the HP 3000 to HP 1000 PSI and HSI communications link. 


TRACING FACILITIES. LOG3K is a program which initializes logging and is run interactively to 
determine which device or spoolfile the HP 1000 to HP 3000 messages are to be logged. LOG3K is also 
used to determine what information is to be logged. 


Low Level Tracing For HSI. The Synchronous Line Control Information (SLCIN) program tracks all 
driver activity (DV667) on the HSI card. Long term statistics and single events are listed. To use this 
program successfully, you need to have a strong understanding of bisync protocol. 


TRACE FORMATTING. TRC3K is the utility program for the HP 1000 which allows you to examine 
the messages logged by LOG3K. These messages are formatted into readable form by TRC3K. TRC3K is 
similar in function to DSDUMP on the HP 3000 side with respect to its formatting function. 


Refer to the DS/1000-IV Network Manager's Manual for a complete discussion of the use of these 
programs. 


Additional HP 1000 Troubleshooting Utilities 


In addition to the previously discussed tracing and formatting utilities, DS/1000-IV provides two other 
utilities that you may find useful for network maintenance. These utilities are DSINF and DSMOD. 


DSINF allows you to examine: 
° The Available Memory Suspend list 
e I/O classes in use 


e DS Values, including Resource Numbers, Class Numbers assigned to DS programs, and time-out 
values 


e The Transaction Control Blocks in the DS SAM block 
e DS Lists 


e Network Routing Vector Specifications 


*, 
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Troubleshooting 


e DS Equipment Table entries 

e Synchronous Link Control (DVG67) long term statistics 

e Message Accounting Values 

e Rerouting Values 

e Remote Sessions active at this node 
Once your node has been initialized, you may schedule DSMOD to make adjustments to parameters set 
during initialization. DSMOD allows you to change the HP 3000 ID sequence, re-enable a link, display 
the NRV, change the non-session password, quiesce the node, schedule additional monitors, adjust timing, 


change the default session user name, and change the Nodal Routing Vector. 


Refer to the DS/1000-IV Network Manager's Manual, Vol I and II, for details on both DSINF and 
DSMOD. 
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APPLICATIONS 
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This section contains information regarding applications on the DS 3000 to 1000 communications link. It 
provides various DS 3000 to 1000 specifications. 


Line Buffer Configuration Limits 


SOFTWARE 





HP 3000 


HP 1000 





HARDWARE 


HP 3000 


HP 1000 





256 - 4095 words 
The software is loaded using one of the 3 available Libraries. 


304 words maximum 
1072 words maximum 
4096 words maximum 


NOTE 


Continuation records will be used when the 
actual transmitted data exceeds the line 
buffer size. 


The entire transfer includes user’s data, plus the DS fixed part of the 
message format, plus an optional appendage. 


INP 304-1024 words maximum 
HSI 304-4095 words maximum 
SSLC 304-4095 words maximum 


PSI 1072 words maximum 
HSI 4096 words maximum 


Applications 


Opening a Line from the HP 3000 


To open the DS line from the HP 3000 side, a :DSCONTROL xx;OPEN is done from a system console. 
Then, the command :DSLINE sx is done to open a line to the HP 1000. If the HP 1000 is not ready to 
accept a DSLINE, this will fail, and the message REMOTE NOT RESPONDING will appear. At this point the 
HP 1000 operator must be instructed to open the DS line from the HP 1000 side. To close a DS line, the 
command :DSLINE 2x;CLOSE is done. If an attempt at opening a DS line from the HP 3000 side fails, a 
sDSLINE ax;CLOSE must be done before another attempt at opening the line can be accomplished. 


Opening a Line from the HP 1000 


To open a line from the HP 1000 side, type the command :RU,DINIT. DINIT enables the communication 
line interface and schedules the DS monitor and queuing programs that service incoming requests from 
remote network nodes. DINIT schedules QUEX, which is a program used to exchange line open 
information with the HP 3000. After a period of time (if the line fails), QUEX goes into a secondary 
state, and will accept an incoming connection with a HP 3000. The HP 3000 side operator must type ina 
:DSCONTROL xx;OPEN, before a line from the HP 1000 can be opened. To reinstate the HP 1000 side as 
a primary station (allowing you to make the connection from the HP 1000 side), type the command, 
DSMOD/L. 


Session 


Some HP 1000s have the ability to offer users some isolation from other users through a capability called 
SESSION. SESSION provides a unique environment for each user, where capability levels, private disc 
space, device access, etc. can be specified for each logon account. For instance, if a user wishes to access a 
certain file which resides in a private disc area, the user must logon to an account which has access to that 
area of the disc. 


When accessing an HP 1000 (with Session Monitor installed) from an HP 3000, you may wish to make the 
access under a session. This is done transparently to the HP 3000 user by providing a default logon for 
requests received from the HP 3000. The capability level, disc space, device access, etc. is set up for that 
default session by the HP 1000 Network Manager. This default logon is generally given low capabilities 
as a security measure. For most HP 3000 users, access will be made by interactively (HELLO), or 
programmatically (HELLO command) logging on to a specific account on the HP 1000. The HP 3000 user 
then has the capabilities of that specific logon. For example, if an HP 3000 user wishes to access data 
stored in a private file on the HP 1000, the user will have to issue a logon to a specific account that has 
access to that file before attempting to access the file with remote file access calls. For more details on 
session versus non-session access, refer to "Opening A Line" in Section 2 of this manual. 


It is important to note that the session established on the HP 1000 is a non-interactive session. There is 
no FMGR associated with the session; so the only commands that can be processed are RTE system level 
commands, and DS level DEXEC, RFA, and PTOP calls. 


Running FMGR on the HP 1000 


The only method for issuing remote FMGR commands on the HP 1000 is to place a FMGR transfer file 
on the HP 1000 and then issue the command REMOTE RU,FMGR,trfile. FMGR will run on the 
HP 1000, open the transfer file and execute the commands that it contains. The output of the FMGR 
will go to the system console of the HP 1000. 























Applications 


The request to RU,FMGR causes the actual FMGR program to run (not a 
copy of it). This will tie up FMGR until the transfer file has completed, 
and keep other users on the HP 1000 from logging on (they will not be able 
to get a copy of FMGR for their session). You must also be very careful to 
EX,SP from FMGR at the end of the transfer file or FMGR will be tied up 
to your session until you terminate it (BYE), or it times out. Exercise 
caution when running FMGR from the HP 3000. 


The MOve Command 


DS/1000-IV provides the ability to move files between HP 1000s and HP 3000s with a simple user 
command from RMOTE (the user interface program to the HP 3000). This capability requires 
master-slave software to be installed in both computers. The relocatable “RMOTE1 is a version of 
RMOTE that utilizes a slave program, called COPY3K.PUB.SYS on the HP 3000 to transfer files. The file 
transfer is accomplished with the RMOTE MO command. Refer to the RMOTE section of the 
DS/1000-IV User's Manual for more information. 


NOTE 


COPY3K must exist on the HP 3000 to use the RMOTE MO command. The 
DS/1000-IV Network Manager's Manual, Vol. I, contains installation 
instructions. 


PTOP Testing Using DSTEST 


DS/1000-IV provides a slave program, DSTES (ZDSTES), which can be loaded on the HP 1000 for 
verification of the DS PTOP software. Load DSTES, and be sure that it is RPed (given an ID segment). 
From the HP 3000, open the DS line to the HP 1000 and run DSTEST for verification of the PTOP 
software. See Appendix C in this manual for more information. 














APPENDIX 


DS/3000 operation requires the installation and configuration of one communications interface for each 
line to a remote computer. 


CONFIGURATION DIALOGUE 





This section explains how to configure the following: 
e Intelligent Network Processor (INP) 
e Synchronous Single-Line Controller (SSLC) 
e Hardwired Serial Interface (HSI) 
e DS Line Monitor (communications driver IODSO or IODSX) 


e DS Virtual Terminals (IODSTRMO, IODSTRMX) -- one for each session that will be 
allowed on your system from a remote system. 


The same communications interface (INP, SSLC, or HSI) can be used by another HP 3000 data 
communications subsystem (such as MRJE) when it is not being used by DS/3000. In such a case, the 
communications interface is configured once for each subsystem (each time with a unique logical device 
number, but always with the same DRT number). Keep in mind that the following dialogue applies only 
when the interface is used for DS/3000 activity, and that a response that is optional for DS/3000 may 
not be optional for one of the other subsystems. Configuration guidelines pertaining to the other 
subsystems are given in the reference manual for each subsystem. Configuration summary tables for each 
of the communications interface types are included in the Data Communications Handbook and in the HP 
3000 Computer Systems, System Manager/System Supervisor Reference Manual (HP 3000 Computer 
Systems, MPE V System Operation and Resource Management Reference Manual, if you are using MPE 
V/E). 


For any data communications subsystem to function, CS/3000 modules must be present on the system. It 
is presumed in this configuration description that the Account Systems Engineer (SE) has already installed 
CS/3000. 


If you are making any other changes to the MPE I/O system, refer to the System Manager / System 
Supervisor Reference Manual (HP 3000 Computer Systems, MPE V System Operation and Resource 
Management Reference Manual, if you are using MPE V/E). 


Configuration is accomplished through an interactive dialogue between you and the computer system. As 


the questions or prompts appear on your console, enter the appropriate replies through the console 
keyboard for your desired system configuration. 


NOTE 


In all responses, Y or N can be used for YES or NO. A 
is equivalent to NO. 


Configuration Dialog 


Prior to entering the dialogue, log onto the system and input a file reference to a magnetic tape, as 
follows: 


:FILE name;DEV=TAPE 
:SYSDUMP #name 


The dialogue commences as follows: 


STEP NO. DIALOGUE 


1 ANY CHANGES? YES 

2 SYSTEM ID = HP 32033 v.uu.ff? (RETURN) 

3 MEMORY SIZE= xxxx (MIN = yyy,MAX = yyyyy)? 
4 I/O CONFIGURATION CHANGES? YES 

5 LIST I/O DEVICES? YES 


All I/O devices currently configured on the system are listed with the following 
column headings: 








LOG DEV Logical device number. 

DRT # Hardware device address (Device Reference Table 
number) configured on the interface board. 

UNIT Hardware unit number of device on its controller. 

CHAN Channel number of device on its controller. 

TYPE Device type. 

SUB TYPE Device subtype. 

TERM TYPE Terminal type. 

TERM SPEED Terminal speed. 

REC WIDTH Record width in decimal words. 

OUTPUT DEV Device class name or device Idn. 

MODE J = Accept jobs 


DRIVER NAME 


DEVICE CLASSES 


A = Accept data 

I = Interactive device 
D = Duplicative device 
S = Spooled device 


Driver name. 


Class name assigned to the interface. 














Configuration Dialog 


NOTE 


The prompt in Step 6, below, appears only if a 
communications subsystem (CS) device was previously 
configured into the system. 


STEP NO. DIALOGUE 


6 LIST CS DEVICES? YES 


A list of all CS devices currently assigned to the system is printed with the 


following column headings: 


LDN 





PM 


PRT 


LCL MOD 


TC 


RCV TMOUT 





LCL TMOUT 


CON TMOUT 


MODE 





TRANSMIT SPEED 


™ 


BUFFER SIZE 


DC 


DRIVER OPTION 





Logical device number. 

Port Mask. (Not used by INP and SSLC) 
Protocol. 

Local mode. 

Transmission code. 

Receive timeout (in seconds). 

Local timeout (in seconds) 

Connect timeout (in seconds). 

O = Dial out. 

I = Manual answer. 

A = Automatic answer. 

D = Dual speed. 

H = Half speed. 

C = Speed changeable. 

Transmission speed (characters per second.) 
Transmission mode. 

Default buffer capacity, in words. 


Driver changeable or not changeable. 


Driver options. 


Configuration Dialog 


STEP NO. DIALOGUE 


Meas 7 


If you have a switched device, such as those that are connected through a dial-up 
telephone line, then you receive the following additional information: 


LDN INP or SSLC logical device number. 
CTRL LEN Not currently implemented. 


PHONE NUMBER LIST A single telephone number -~ the default for the 
data communications line. 


LOCAL ID SEQUENCE The default identification of the local computer. 
REMOTE ID SEQUENCE The default identification of the remote computer. 


7 LIST DEVICE DEFAULTS? 





8 HIGHEST DRT=xxx? 


In the output, xxx is a value denoting the present highest DRT entry number 
that can be assigned to a device. 


To change xxx, enter the new value desired. If the highest-numbered device 
in the configuration is a device that uses more than one DRT entry (such as a 
terminal controller with one or two data set controllers), be sure to enter the 
highest of the DRT numbers. m™, 


To maintain the current xxx, enter (RETURN). ae 
9 LOGICAL DEVICE #? 

‘To specify a device to be added or removed, enter the logical device number of 

that device. An HSI has four ports and thus can be configured up to four 

times with a unique logical device number for each port. In addition, a 

communications driver (IODSO) with a unique logical device number must be 


configured for each HSI port configured. ar 


This prompt is repeated later in the configuration dialogue, so that you can 
return to this point to configure more than one device. 


Entering 0 or will take you to Step 50. 


10 DEVICE NAME? (ETURN) 


E-4 


Configuration Dialog 


STEP NO. DIALOGUE 





11 DRT #? 


To add a device, enter its DRT entry number. For a communications driver 
and a virtual terminal, you must assign the logical device number of the 
associated communications interface (INP, SSLC, or the HSI port), preceded by 
a number sign (#). 


Virtual terminals need to be configured for only one port of any HSI (back 
referenced to only one logical device number for the HSI). The terminals will 
be dynamically allocated to the proper port when a user opens it. 


To remove a device and return to Step 9, enter zero. 





12 UNIT #20 
13 SOFTWARE CHANNEL #? 0 
14 TYPE? 


Enter the device type, where 
16 = Virtual Terminals (IODSTRMO or IODSTRMX) 


17 = Intelligent Network Processor (INP) 





18 = Synchronous Single-Line Controller (SSLC) 
19 = Hardwired Serial Interface (HSI) 


41 = Communications Driver (IODSO or IODSX) 


NOTE 


When configuring device type 16, consider the maximum 
number of terminals supported by your system. Each 
virtual terminal configured is added to the total number of 
terminals already on the system. This information is 
available from your HP Sales Representative. 








Configuration Dialog 


STEP NO. DIALOGUE 
15 SUB TYPE? 


Communications Interface: 
For an INP, enter 0, 1, or 3 
For an SSLC, enter 0 or 1 
For an HSI, enter 3, where 
0 = switched line with modem 
1 = nonswitched line with modem or modem eliminator cable 
3 = hardwired line, synchronous transmission 


Communications Driver: 
For IODSO or IODSX, enter 0 or 1, where 
0 = no data compression 
1 = data compression 


Virtual Terminal: 


For IODSTRMO or IODSTRMxX, always enter 8. The 8 is used only for 
HP 3000 to HP 1000 communications. 


NOTE 


If you are configuring a terminal (type 16), the dialogue 
continues to Step 16. If you are configuring an HSI (Type 
19), the dialogue skips to Step 18. If you are configuring an 
SSLC (Type 18), the dialogue skips to Step 19. If you are 
configuring an INP (type 17), the dialogue skips to Step 22. 
For all other device types, the dialogue skips to Step 36. 


16 For MPE V/E: 


ENTER [TERM TYPE #], [DESCRIPTOR FILENAME] ? 


This question is asked only if the device type is 16, or if it is 32 with a 
subtype of 14 or 15. Term type is always 0 for DS/3000 Virtual Terminals. 


For MPE IV: 
TERM TYPE? 0 


This question is asked only if Type is 16. Term Type is always zero for 
DS/3000 Virtual Terminals. 


17 SPEED IN CHARACTERS PER SECOND? 0 


This question is asked only if device Type is 16, then the dialogue skips to Step 
36. 








Configuration Dialog 


STEP NO. DIALOGUE 





18 PORTMASK? 

This question is asked only if device Type is 19 (HSI). The values allowable 
are shown below and must be entered in decimal. This forms a mask 
indicating which HSI channel will be used. Only one of the four channels 
may be designated for each unique logical device number. 

Enter 8 for HSI cable connector port 0. 

Enter 4 for HSI cable connector port 1. 

Enter 2 for HSI cable connector port 2. 

Enter 1 for HSI cable connector port 3. 

Since only one port on the HSI PCA can be opened at a time, only one block of 
virtual terminals (entered later in this configuration) are needed for that HSI 


PCA. This same block is automatically reallocated to each new port opened. 
One block of virtual terminals serves all ports. 





19 PROTOCOL? 1 
This response defines Binary Synchronous Communications. 


20 LOCAL MODE? 





DS/3000 does not use this response. Enter 1. 








Configuration Dialog 


STEP NO. 


21 


22 


23 


24 


DIALOGUE 


TRANSMISSION CODE? 


For an HSI, enter 1. 


For an SSLC, enter 1, 2, or 3, where 

1 = Automatic code sensing of ASCII and EBCDIC if 
initially receiving; ASCII if initially sending; 

2 = ASCII transmission. 

3 = EBCDIC transmission. 


In DS/3000, all transmissions are ASCII. Only in certain other data 
communication subsystems can users optionally transfer EBCDIC characters. 


RECEIVE TIMEOUT? 


LOCAL 


Enter the positive number of seconds the CS device will wait to receive text 
before terminating the read mode. Entering provides a 20-second 
timeout. 


NOTE 


For all timeout responses, entering 0 disables the timeout. 
The maximum timeout is 32000 seconds. DS displays an 
error when the communications software (CS) disconnects 
because of a timeout. 


TIMEOUT? 


Enter the positive number of seconds a connected local station will wait to 
transmit or receive before disconnecting. Entering provides a 
60-second timeout. 


CONNECT TIMEOUT? 


Enter the positive number of seconds the local station will wait after one 
attempt to make a connection to a remote station. Entering provides 
a 900-second timeout. For an HSI, 100 to $00 is recommended. For an INP 
or SSLC, 300 is recommended. 
































STEP NO. 


25 


26 


27 


28 


29 


30 


Configuration Dialog 


NOTE 


Steps 25 through 27 apply only to CS devices with switched 
lines connected through a modem (dial telephones, subtype 
0). For CS devices with nonswitched lines connected 
through a modem (private lines, subtype 1), the dialogue 
skips to Step 28. If the CS device is either an HSI or a 
hardwired INP (subtype 3), the dialogue skips to Step 30. 


DIALOGUE 
DIAL FACILITY? 


Enter YES if manual dial-up is required. Enter the INP LDEV# if the 
AUTO DIAL feature is used. Enter NO if no dial facility is required. 


ANSWER FACILITY? 


Enter YES if the local modem can answer calls, either manually or 
automatically. Enter NO if it cannot. A NO response causes the next step to 
be skipped. 


AUTOMATIC ANSWER? 


Enter YES if the local modem can automatically answer calls. Enter NO if 
manual answering is required. 


DUAL SPEED? 


Enter YES if the local modem is dual speed (European models). Enter NO if it 
is Single speed. A NO response causes the next step to be skipped. 


HALF SPEED? 


Enter YES if the local modem is to operate at half speed. Enter NO if it is to 
operate at full speed. The dialogue skips to Step 29. 


SPEED CHANGEABLE? 
For an HSI, enter YES. 


For an INP, enter YES if the speed of the line is changeable. Enter NO if the 
line speed is fixed. In general, the speed is changeable when the 
communications interface provides the clocking, and it is not changeable 
when a single-speed modem or other external device provides the clocking. 
You must respond YES if the console operator will be using the speed 
parameter in the :DSCONTROL command to override the configured 
transmission speed (see Step 31). 
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Configuration Dialog 


STEP NO. DIALOGUE 


31 TRANSMISSION SPEED? 


For INP (Type 17) or SSLC (Type 18) devices, enter the transmission speed of 
the line in characters per second (Bit Rate/8). For HSI (Type 19) devices, 
enter 250000 for cable lengths up to 1000 feet, or enter 125000 for cable 
lengths greater than 1000 feet. 


The transmission speed you specify is ignored for modems that provide 
internal clocking signals. This allows modems of different speeds to be used 
without reconfiguring the Operating System. The speed specified is used if 
the modems are eliminated and the controllers are hardwired together. 


The speed you specify becomes the default. The console operator can override 
the default by including the speed parameter in the :DSCONTROL command, if 
you answered YES to Step 30. 











Configuration Dialog 


STEP NO. DIALOGUE 





32 TRANSMISSION MODE? 


Enter the appropriate number for the transmission mode in use. The mode 
numbers are: 


0 = Full duplex 
1 = Half duplex 


INP and SSLC: 


Configure the communications interface (INP or SSLC) to operate in Full 
Duplex (0) if your facility uses one of the following: 


eA leased line with four-wire, point-to-point installation. 


e A dial network with two lines (four-wire equivalent). 





e A dial network with Wide Band Service. 
e Any Direct Connect cable between two INPs. 


Configure the communications interface to operate in Half Duplex (1) if your 
facility uses the following: 





e A dial network with a single-line (two-wire) installation. 


e An INP-to-SSLC Direct Connect cable (a "modem eliminator" cable 
between an INP and an SSLC) 


Your response must agree with the remote system’s configuration and with the 
characteristics of the communications line. 


HSI: 





Always configure an HSI as Full Duplex (0). 





Configuration Dialog 


STEP NO. DIALOGUE 





33 PREFERRED BUFFER SIZE? ae 


Enter, in words, the desired buffer size, to a maximum of 4095 words for an 
HSI or SSLC, or up to a maximum of 1024 words for an INP. For a dial-up 
line, 1024 is generally recommended; for a leased line with an SSLC, the size 
may be larger than 1024 if the line quality is good. Note that although large 
buffer sizes increase transmission efficiency, they also use up memory space. 
Match buffer sizes for sender and receiver whenever possible, since the 
effective buffer size that can be utilized is the smaller of the two. 


34 DRIVER CHANGEABLE? NO 


35 DRIVER OPTIONS? 0 





NOTE 


The dialogue skips to Step 44. 


36 RECORD WIDTH? 


For IODSO and IODSX, enter 128. 





For all Virtual Terminals, enter 40. es 
37 OUTPUT DEVICE? 
For the communications drivers, enter 0. 


For a virtual terminal, enter the class name or logical device number to be 
used for the corresponding job/session listing device. 





38 ACCEPT JOBS/SESSIONS? Least 
For the communications drivers, enter NO. 
For virtual terminals, enter YES. 


39 ACCEPT DATA? NO 





Configuration Dialog 


STEP NO. DIALOGUE 





40 INTERACTIVE? 
For the communications drivers, enter NO. 
For virtual terminals, enter YES. 

41 DUPLICATIVE? 
For the communications drivers, enter NO. 


For virtual terminals, enter YES. 


42 INITIALLY SPOOLED? NO 
43 AUTO REPLY? NO 
44 DRIVER NAME? 





Enter the name of the driver for this device as follows: 
IOINPO =INP 
CSSBSCO =SSLC 


CSHBSCO = HSI 





IODSsoO = Communications driver, while using the Bisync protocol 
IODSX = Communications driver, while utilizing the X.25 capability 
IODSTRMO = Virtual terminals, while using the bisync protocol 


IODSTRMX = Virtual terminals, while utilizing the X.25 capability 


NOTE 


Steps 45 through 48 apply to CS devices with switched 
(dial-up) lines (types 17 and 18, subtype 0). The dialogue 
for all other devices skips to Step 49. 








Configuration Dialog 


STEP NO. DIALOGUE 


4$ PHONELIST? 


Enter YES or NO. 


You can supply one number (usually a frequently dialed number) which will 
be the system default. 


46 PHONE NUMBER? 


Enter a string of numbers and hyphens, but not more than 30 characters. 
This number will be included in the I/O request on the system console when a 
user OPENs a dial-up line. 

The characters that can be used for the phone number are: 

O through 9 

/ (separator used for automatic call units that have a second dial tone detect) 


E (optional end-of -number indicator) 


D (one-second delay. Used for European modems and automatic call units 
that require built-in delays) 


# (defined by the local telephone system) 


* (defined by the local telephone system) 


47 LOCAL ID SEQUENCE? 


The default local ID sequence can be specified in ASCII. Enter for a 
null local ID sequence, or enter an ASCII string in quotes. 


NOTE 


Do not enter more than 16 characters for the local or 
remote ID sequence. 

















Configuration Dialog 


STEP NO. DIALOGUE 





48 REMOTE ID SEQUENCE? 


Enter the default remote ID sequence in the same format as the local ID 
sequence (above). This can be repeated until is entered. 


49 DEVICE CLASSES? 


Enter a list containing a device class name (up to eight alphanumeric 
characters, beginning with a letter). Class names are separated from each 
other by commas. These names are left to the discretion of the System 
Supervisor. They will be used in certain commands and intrinsics when any 
member of a group of devices (such as any disc drive) can be referenced. No 
name need be entered. 


NOTE 


When configuring X.25 devices, the destination logical node 
name cannot be specified as a device class name for IODSX 
or IOINPO entries. 





The dialogue now prints the LOGICAL DEVICE #? prompt described in Step 
9. If all I/O configuration is complete, press and the dialogue 
continues at Step 50. Otherwise, enter a logical device number and repeat the 
configuration procedure from Step 9. 





50 MAX # OF OPEN SPOOLFILES = xxx? (MIN=0, MAX=yyy) @ETURN) 
51 LIST OF I/O DEVICES? YES 


To print a listing of the new input/output device configuration, enter YES. 
This list appears in the format described in Step 5. 





52 LIST CS DEVICES? YES 


Enter YES to list the characteristics of the new CS device configuration. 


NOTE 


Step 53 only appears if you are using MPE V/E. 


53 TERMINAL TYPE CHANGES? 


Enter NO. 





Configuration Dialog 


STEP NO. DIALOGUE 





54 CLASS CHANGES? - 


55 LIST 1/0 DEVICES? 


NOTE 


The prompt in Step 56 appears only if a CS device is 
configured or if additional drivers exist (for the CS 
driver-changeable option in Step 34). If neither case exists, 
the dialogue skips to Step 58. 








56 ADDITIONAL DRIVER CHANGES? NO 
$7 I/O CONFIGURATION CHANGES? NO 
58 SYSTEM TABLE CHANGES? NO 

59 MISC CONFIGURATION CHANGES? NO 
60 LOGGING CHANGES? NO 

61 DISC ALLOCATION CHANGES? NO 

62 SCHEDULING CHANGES? NO 

63 SEGMENT LIMIT CHANGES? NO 

64 SYSTEM PROGRAM CHANGES? NO 

65 SYSTEM SL CHANGES? NO 





The NO response assumes CS/3000 modules are already present on the system. 














STEP NO. 


66 


67 


68 


69 
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DIALOGUE 
ENTER DUMP DATE? 


Copies the modified MPE. When this copy is used to COLDSTART 
the system, the account structure and all files remain intact. 


mm/dd/yy where mm/dd/yy is some date in the future. Copies the modified 
MPE and the current accounting, but no files. 


mm/dd/yy where mm/dd/yy is usually the date of the most recent system 
backup. Copies the modified MPE, the current accounting structure, 
and any files that were changed on or since the specified date. 


i) Copies the entire system (MPE, the current accounting structure, and 
all files). 


ENTER DUMP FILE SUBSETS? 


Enter (RETURN), or enter a filename or series of filenames. (Example: 
@,PUB.SYS) 


LIST FILES DUMPED? YES or NO 


The console operator must now use the =REPLY command to assign the magnetic tape 
drive on which you have arranged for a tape reel to be mounted. 


After the SYSDUMP is complete, the tape produced should be used to COLDSTART the system. During 
COLDSTART, the old I/O device configuration is replaced with the new one from your SYSDUMP tape. 


HP ASCII CHARACTER SET 





First Character Secend Charscter 
Octal Equivalent Octal Equivatent 


040400 000101 


ASCII 
Character 
A 

















































































B 041000 000102 

Cc 041400 000103 

D 042000 000104 

E 042400 000105 

F 043000 000106 

G 043400 000107 

H 044000 000110 

1 044400 000111 

J 045000 000112 

K 045400 000113 

L 046000 000114 

M 046400 000115 

N 047000 000116 

Oo 047400 000117 

P 050000 000120 

Q 050400 000121 

sain R 051000 000122 
( S 051400 000123 
T 052000 000124 
U 052400 000125 

Vv 053000 000126 

Ww 053400 000127 

x 054000 000130 

Y 054400 000131 

z 055000 000132 






























































































a 060400 000141 
b 061000 000142 
c 061400 000143 
d 062000 000144 
e 062400 000145 
f 063000 000146 
9 063400 000147 
h 064000 000150 
064400 000151 
j 065000 000152 
k 065400 000153 
' 066000 000154 
m 066400 000155 
n 067000 000156 
0 067400 000157 
p 070000 000160 
q 070400 000161 
—_ fr 071000 000162 
s 071400 000163 
t 072000 000164 
u 072400 000165 
¥ 073000 000166 
w 073400 000167 
x 074000 000170 
Y 074400 000171 
z 075000 000172 



































0 030000 000060 
1 030400 000061 
2 031000 000062 
3 031400 000063 
4 032000 000064 
5 032400 000065 
6 033000 000066 
7 033400 000067 
8 034000 000070 
9 034400 000071 





















NUL 000000 000000 
SOH 000400 060001 
STX 001000 000002 
ETX 001400 000003 
EOT 002000 000004 
ENQ 002400 000005 
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ASCII First Character Second Character 
Character Octal Equivalent Octa! Equivalent 


ACK 003000 000006 














































































































































































003400 000007 
004000 000010 
004400 000011 
005000 000012 
005400 000013 
006000 000014 
006400 000015 
007000 000016 
007400 000017 
010000 000020 
010400 000021 
011000 000022 
011400 000023 
012000 000024 
012400 000025 
013000 000026 
013400 000027 
014000 000030 
014400 000031 
015000 000032 
015400 000033 
016000 000034 
016400 000035 
017000 000036 
017400 000037 
020000 000040 
020400 000041 
021000 000042 
021400 000043 
022000 000044 
022400 060045 
023000 000046 
023400 000047 
024000 000050 
024400 000051 
025000 000052 
025400 000053 
026000 000054 
026400 oocoss 
027000 000056 
027400 000057 
035000 000072 
035400 000073 
036000 000074 
036400 000075 
037000 000076 
037400 000077 
040000 000100 
055400 000133 
056000 000134 
056400 000135 
057000 000136 
057400 000137 
060000 000140 
075400 000173 
076000 000174 
076400 000175 
077000 000176 
077400 000177 





First Character 


Second Character 





ae See Ae eet 
ol ]2}a}s}s[el7{s[sfiofrfiafisfralis 


F=1 


A 


ACCEPT, parameters, 6-6 
ACCEPT call, 6-4 
and GET, 6-4 
and PCONTROL, 6-4 
and POPEN, 6-4 
and PREAD, 6-4 
and PWRIT, 6-4 
error conditions, 6-6 
syntax, 6-4 
Adding a communications driver, E-5 
Adding a device, E-5 
o Adding a virtual terminal, E-5 
Adding devices, and maximum number of devices, E-5 
ASCII, E-8 
ASCII and EBCDIC, E-8 





Cc 


Cable 
| Direct Connect, E-11 
oe modem eliminator, E-11 
Closing a DS line, 1-6 
Closing a line, 2-40 
DSLINE parameters, 2-40 
DSLINE syntax, 2-40 
examples, 2-40 
COLDSTART, E-17 
Communications driver, E-13 
adding, E-5 
- with X.25, E-13 
, Communications Driver, E-5, E-6 
Communications interface, 2-2 
drivers, 2-8 
Hardwired Serial Interface (HSI), 2-2 
Intelligent Network Processor (INP), 2-3 
Programmable Serial Interface (PSI), 2-3 
CS/3000, E-1, E-3 
CS/3000 trace facility for the HP 3000, C-3 
CSDUMP trace formatting program for the HP 3000, C-3 
CSHBSCO, E-13 
CSSBSCO, E-13 
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D 


DAPOS call, 5-5 
error condtions, 5-5 
parameters, 5-5 
syntax, 5-5 
DCLOS call, 5-6 
error conditions, 5-6 
parameters, 5-6 
syntax, 5-6 
DCONT call, 5-8 
error conditions, 5-8 
parameters, 5-8 
syntax, 5-8 
DCRET call, 5-9 
error conditions, 5-10 
parameters, 5-9 
syntax, 5-9 
Default speed, overriding, E-10 
Device 
adding, E-5 
removing, E-5 
Device Reference Table number, E-2 
Device type, E-2 
Devices 
switched, E-9, E-13 
DEXEC call elements, 4-3 
functional return, 4-4 
syntax, 4-3 
DEXEC calls 
capabilities, 4-1 
error checking routine example, 4-4 
I/O CONTROL, 4-10 
I/O STATUS, 4-16 
program example, 4-17 
PROGRAM SCHEDULE, 4-11 
READ, 4-6 
table of calls and their functions, 4-2 
TIME REQUEST, 4-13 
TIMED PROGRAM SCHEDULE, 4-14 
WRITE, 4-8 
DEXEC error messages 
condition code = CCG, A-13 
condition code = CCL, A-14 
Dial networks 
with four wire equivalent, E-11 
with single-line installation, E-11 
with two lines, E-11 
with two-wire installation, E-11 
with Wide Band Service, E-11 
Dialing the remote computer, 2-20 
default situation, 2-20 
DINIT, D-2 
Direct Connect cable, E-11 
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Disabling, timeout, E-8 
DLOCF call, 5-11 
error conditions, 5-12 
parameters, 5-11 
syntax, 5-11 
DNAME call, 5-13 
error conditions, 5-13 
parameters, 5-13 
syntax, 5-13 
DOPEN call, 5-14 
error conditions, 5-15 
parameters, 5-14 
syntax, 5-14 
DPOSN call, 5-16 
error conditions, 5-16 
parameters, 5-16 
syntax, 5-16 
DPURG call, 5-17 
error condtions, 5-17 
parameters, 5-17 
syntax, 5-17 
DREAD call, 5-18 
error conditions, 5-18 
parameters, 5-18 
syntax, 5-18 
Driver name, E-2 
Drivers, 2-8 
DRT number, E-2, E-4 
DS Line Monitor, E-1 
DS/3000 capabilities, 1-1 
DS/3000 functional errors, A-3 
DSCONTROL 
command execution order, B-5 
examples, B-7 
operation, B-5 
parameters, B-2 
syntax, B-2 
DSCONTROL error messages, A-6 
DSCONTROL informatory messages, A-6 
DSDUMP trace formatting program for the HP 3000, C-3 
DSINF, C-4 
DSLINE 
parameters for closing a line, 2-40 
syntax for closing a line, 2-40 
DSLINE command, 2-17 
line buffer considerations, 2-3 
line buffer specification, 2-6 
parameters, 2-17 
specifying ID sequences, 2-20 
syntax, 2-17 
DSLINE syntax errors, A-2 
DSLIST, C-1 
DSMOD, C-4 


Index 
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Index 


DSTAT call, 5-19 
error conditions, 5-19 
parameters, 5-19 
syntax, 5-19 

DSTEST, C-1, D-3 
default mode, C-2 
diagnostic mode, C-2 
examples, C-2 

Dump date, E-17 

DWIND call, 5-20 
error conditions, 5-20 
parameters, 5-20 
syntax, 5-20 

DWRIT call, 5-21 
error conditions, 5-21 
parameters, 5-21 
syntax, 5-21 


E 


EBCDIC, E-8 
EBCDIC and ASCII, E-8 
Editing HP 1000 files, 3-6 
Error messages 
DEXEC, A-13, A-14 
DS/3000 functional errors, A-3 
DSCONTROL, A-6 
DSCONTROL informatory messages, A-6 
DSLINE, A-2 
RFA, A-10, A-12 
Establishing a communications link, 3-2 
Establishing a remote session, 3-2 
Examples 
closing a DS line, 1-6 
closing a line with DSLINE, 2-40 
DEXEC call error checking routine, 4-4 
DSCONTROL, B-7 
establishing multiple lines (hardwired), 2-30 
establishing multiple lines (telephone lines), 2-34 
exclusive option example, 2-23 
FORTRAN program using RFA calls, 5-25 
HP 1000 master - HP 3000 slave PTOP programs , 6-26 
HP 3000 master - HP 1000 slave PTOP programs, 6-22 
initiating a remote session, 1-3 
issuing a remote RTE command, 1-5 
multiple user (dial-up line), 2-24, 2-26, 2-28 
multiple user (hardwired), 2-22 
opening a DS line, 1-5 
program using DEXEC calls, 4-17 
RFA error checking routine, 5-3 
running DSTEST, C-2 
SPL program using RFA calls, 5-22 
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J 





Index 


Exclusive line access, 2-21 

Exclusive option example (hardwired), 2-23 
Executable RTE operator commands, 3-4 
Executable RTE system commands, 3-1 
Executing multiple remote RTE commands, 3-3 
Exiting a remote session, 3-5 


F 


File Management Program (FMGR), 3-6, D-2 
FMGR, 3-6, D-2 

Four-wire, E-11 

Full Duplex, E-11 


G 


GET call, 6-7 
error conditions, 6-9 
functional return, 6-7 
parameters, 6-8 
syntax, 6-7 


H 


Half duplex, E-11 
Hardware and software requirements, 2-1 
Hardware device address, E-2 
Hardwired Serial Interface, E-1, E-4, E-5, E-6, E-7, E-8, E-9, E-11, E-13 
adding, E-5 
Hardwired Serial Interface connection, 2-2 
HP 1000 troubleshooting, C-4 
LOG 3K, C-4 
low level tracing for HSI, C-4 
SLCIN tracing facility, C-4 
trace facilities, C-4 
TRC3K, C-4 
HP 3000 to HP 1000 communications 
capabilities, 1-2 
Hardware requirements, 2-1 
Software requirements, 2-1 
HP 3000 troubleshooting and tracing, C-1 
DSLIST, C-1 
DSTEST, C-1 
HSI, E-1, E-4, E-5, E-6, E-7, E-8, E-9, E-11, E-13 
adding, E-5 
hardwired sample I/O device table, 2-8 
interface connection, 2-2 
line buffer configuration limits, D-1 
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I/O CONTROL call, 4-10 
error conditions, 4-10 
funtional return, 4-10 
parameters, 4-10 
syntax, 4-10 
I/O device table samples, 2-8 
I/O devices, E-2 
I/O STATUS call, 4-16 
error conditions, 4-16 
parameters, 4-16 
syntax, 4-16 
ID sequence exchange, 2-20 
telephone connection, 2-6 
ID sequences, 2-20 
default, 2-20 
Initiating a remote session, !~-3 
INP, E-1, E-3, E-5, E-6, E-9, E-13 
adding, E-5 
connection, 2-3 
dialup sample I/O device table, 2-14 
hardwired sample I/O device table, 2-10 
line buffer configuration limits, D-1 
INP communications interface, telephone connection, 2-5 
INP to PSI 
compared to HSI connection, 2-3 
line buffering, 2-3 
speed capabilities, 2-3 
INP-to-SSLC Direct Connect cable, E-11 
Intelligent Network Processor (INP), E-1, E-3, E-5, E-6, E-9, E-13 
adding, E-5 
connection, 2-3 
Interfaces, and use with other subsystems, E-1 
IODSO, E-1, E-6, E-13 
IODSTRMO, E-1, E-6, E-13 
IODSTRMxX, E-1, E-6, E-13 
IODSX, E-1, E-6, E-13 
IOINPO, E-13 
Issuing local commands, 3-5 
exiting a remote session, 3-5 
Issuing remote RTE commands, 1-5, 3-2 
executable RTE operator commands, 3-4 
from a batch job, 3-4 


L 


LDEV, E-3 

LDN, E-3 

Leased line, E-11 

Leaving SYSDUMP, E~4, E-15 
Leaving system I/O configuration, E-4 
Leaving system I/O configurator, E-15 
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Limitations 
editing HP 1000 files interactively, 3-6 
interactive access of RTE subsystems, 3-6 
line buffer configuration, D-1 
running the File Management Program (FMGR), 3-6 
Line buffering, 2-3 
configuration limits, D- 1 
INP to PSI, 2-3 
telephone connection, 2-6 
Line opening failures, 2-38 
LOG3K, C-4 
LOG3K trace facility for the HP 1000, C-4 
Logical device number, E-3 


Maximum number of devices, E-5 

Modem eliminator cable, E-11 

Modems, with internal clocking signals, E-10 
MOve command on the HP 1000, D-3 

MPE I/O System, changes to, E-1 

MPE IV, E-6 

MPE V, E-6 

Multiple line example (hardwired), 2-30 
Multiple line example (telephone lines), 2-34 
Multiple user example (dial-up line), 2-24, 2-26, 2-28 
Multiple user example (hardwired), 2-22 
Multiple user line access, 2-21 


Non-session access versus session access on the HP 1000, 2-5, 2-7, 3-1 


O 


Opening a DS line, 1-5 

Opening a hardwired line, 2-2 

Opening a line, 2-2 
dialing the remote computer, 2-20 
exclusive access, 2-21 
exclusive option example (hardwired), 2-23 
Hardwired, 2-2 
ID sequences, 2-20 
line opening failures, 2-38 
multiple line example (hardwired), 2-30 
multiple line example (telephone lines), 2-34 
multiple lines, 2-29 
multiple user example (dial-up line), 2-24, 2-26, 2-28 
multiple user example (hardwired), 2-22 
multiple users, 2-21 
specifying a line, 2-7 
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telephone connection, 2-5 
Opening a Line, X. 25 line specification, 2-16 
Opening a line from the HP 1000, D-2 
Opening a line from the HP 3000, D-2 
Opening a telephone line, 2-5 

autodial, 2-7 

communications interface, 2-5 

dialing, 2-6 

ID sequence exchange, 2-6 

INP interface, 2-5 

PSI interface, 2-5 

SSLC interface, 2-5 
Opening multiple DS lines, 2-29, 3-2 
Output dev, E-2 
Overriding default speed, E-10 


p 


PCHECK call, 6-10 

error conditions, 6-10 

functional return, 6-10 

parameters, 6-10 

syntax, 6-10 
PCLOSE call, 6-11 

error conditions, 6-11 

parameters, 6-11 

syntax, 6-11 
PCONTROL call, 6-12 

error conditions, 6-12 

parameters, 6-12 

syntax, 6-12 
Performance considerations, PTOP versus RFA, 6~3 
Point-to-point, E-11 
POPEN call, 6-14 

error conditions, 6-15 

functional return, 6-14 

‘parameters, 6-14 

syntax, 6-14 
PREAD call, 6-17 

error conditions, 6-18 

functional return, 6-17 

syntax, 6-17 
PROGRAM SCHEDULE, error conditions, 4-12 
PROGRAM SCHEDULE call, 4-11 

functional return, 4-11 

parameters, 4-11 

syntax, 4-11 
Program-To-Program communications, see PTOP 
Programmable Serial Interface connection, see PSI 
PSI 

connection, 2-3 

line buffering, 2-3 

line buffer configuration limits, D-1 
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Index 


speed capabilities, 2-3 
telephone connection, 2-5 
PTOP 
buffer size, 6-3 
capabilities, 6-1 
master program calls for the HP 3000 and HP 1000 (table), 6-1 
performance considerations, 6-3 
slave program calls for the HP 3000 and HP 1000 (table), 6-2 
PTOP calls (see also, individual call index listings) 
ACCEPT, 6-4 
GET, 6-7 
HP 1000 master - HP 3000 slave program examples, 6-26 
HP 3000 master - HP 1000 slave program examples, 6-22 
PCHECK, 6-10 
PCLOSE, 6-11 
PCONTROL, 6-12 
POPEN, 6-14 
PREAD, 6-17 
PWRITE, 6-19 
REJECT, 6-21 
PTOP testing using DSTEST, D-3 
PTOP versus RFA performance considerations, 6-3 
PWRITE call, 6-19 
error conditions, 6-20 
parameters, 6-19 
syntax, 6-19 











R 


READ call, 4-6 
error conditions, 4-7 
functional return, 4-6 
parameters, 4-6 
syntax, 4-6 
Rec width, E-2 
Record width, E-2 
REJECT call, 6-21 
error conditions, 6-21 
parameters, 6-21 
syntax, 6-21 
Remote File Access, see RFA, 5-1 
Remote session capabilities, 3-1 
Removing a device, E~5 
RFA 
capabilities, 5-1 
description of error conditions and parameters, 5-3 
error checking routine example, 5-3 
RFA and FMP cross referencing (table), 5-2 
RFA calls (see also, individual call index listings) 
DAPOS, 5-5 
DCLOS, 5-6 
DCRET, 5-9 
DLOCF, 5-11 
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DNAME, 5-13 
DOPEN, 5-14 
DPOSN, 5-16 
DPURG, 5-17 
DREAD, 5-18 
DSTAT, 5-19 
DWIND, 5-20 
DWRIT, 5-21 
FORTRAN program example, 5-25 
SPL program example, 5-22 
RFA error messages 
condition code = CCE, A-10 
condition code = CCL, A-12 
RFA versus PTOP performance considerations, 6-3 
RMOTE, D-3 
RTE subsystems 
interactive access, 3-6 
limitations to interactive access, 3-6 








S 


Sample I/O device tables 
HSI hardwired, 2-8 
INP dialup, 2-14 
INP hardwired, 2-10 
SSLC dialup, 2-12 fie 

Saving SYSDUMP, E-2 } 

Saving System I/O Configuration, E-2 

Session access versus non-session access on the HP 1000, 2-5, 2-7, 3-1 

Sessions access on the HP 1000, D-2 

SLCIN trace facility for the HP 1000, C-4 

Specifying a line, 2-7 

Speed, overriding default, E-10 

SSLC, E-1, E-3, E-5, E-6, E-8, E-13 
adding, E-5 
dialup sample I/O device table, 2-12 
line buffer configuration limits, D-1 

SSLC communications interface, telephone connection, 2-5 

Sub type, E-2 

Subsystems, and use with interfaces, E-1 

Subtype, E-6 

Switched devices, E-9, E-13 
and SYSDUMP, E-4 
and system I/O configuration, E-4 . 

Synchronous Line Control Information, see SLCIN 

Synchronous Single-Line Controller, E-1, E-3, E-5, E-6, E-8, E-13 
adding, E-5 

SYSDUMP, E-1 
leaving, E-4, E-15 
saving, E-2 
with switched devices, E-4 

System I/O configuration 
leaving, E-4 
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with switched devices, E-4 
System I/O Configuration, E-1 
saving, E-2 
System I/O configurator, leaving, E-15 


T 


Term speed, E-2 
Terminal] speed, E-2 
Terminating a remote session, 3-5 
TIME REQUEST call, 4-13 
error conditions, 4-13 
parameters, 4-13 
syntax, 4-13 
TIMED PROGRAM SCHEDULE call, 4-14 
error conditions, 4-15 
parameters, 4-14 
syntax, 4-14 
Timeout, disabling, E-8 
Trace formatting for the HP 1000, C-4 
Trace formatting for the HP 3000, C-3 
Tracing facility for the HP 1000, C-4 
Tracing facility for the HP 3000, C-3 
TRC3K, C-4 
TRC3K for formatting HP 1000 trace data, C-4 
Troubleshooting the HP 1000, C-4 
Troubleshooting the HP 3000, C-1 
Type, E-5 
Type 16, E-6 
Type 19, E-7 
Type 32, E-6 


U 


Using the remote subsystem from a batch job, 3-4 


V 
Virtual terminal, E-6, E-13 
adding, E-5 
with X.25, E-13 
Virtual terminals, E-1 


W 


Wide Band Service, E-11 
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WRITE call, 4-8 
error conditions, 4-9 
functional return, 4-8 
parameters, 4-8 
syntax, 4-8 


X 


X.25, E-13 
X.25 line specification, 2-16 
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